This topic has not yet been rated - Rate this topic

messageFactory Property

Note:
Current information about Live Connect is now available in the Windows Live Developer Center. The information in the following sections is provided for legacy purposes only.

Gets or sets the message factory that enables application-specific messages to be sent and received.

Script: http://js.live.net/4.1/loader.js
Feature: Messenger.Core
Namespace: Microsoft.Live.Messenger

Syntax

JavaScript

// To retrieve:
var messageFactory = instance.get_messageFactory();

// To update:
instance.set_messageFactory(value);

Return Value

An ApplicationMessageFactory object that defines the custom logic that is required for application-specific messages.

Remarks

Examples

The following code example determines whether a message factory has been declared for the user and, if none is detected, creates a new factory and registers it.


            if (!user.get_messageFactory())
            { 
                user.set_messageFactory(new myMessageFactory(user));
                if (!user.get_messageFactory().isRegistered(myApplicationMessage.Id))
                {
                    _user.get_messageFactory().register(_myApplicationMessage.Id);
                }
            }

Exceptions

Exception	Condition
Exception	The property is set and the user is not signed in.
Exception	The user is not using Normal or Full of SessionServices.

Version Information

Windows Live Messenger Connect

Supported in: 4.1

Windows Live Messenger Web Toolkit

Supported in: 3.7, 3.5, 3.1, 3.0, 2.5, 2.0, 1.0

Platforms

Internet Explorer 8.0, Internet Explorer 7.0, Internet Explorer 6.0, Firefox 3.6, Firefox 3.5, Firefox 3.0, Firefox 2.0, Firefox 1.5, Chrome 4.0, Chrome 3.0, Chrome 2.0, Chrome 1.0, Safari 4.0, Safari 3.0, Opera 10.5