Conversation Control

Ff750899.note(en-us,MSDN.10).gifNote:
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.

The Conversation control displays a conversation window and a contact. It is represented in markup by the wl:conversation tag.

The following example shows how to insert the Conversation control into a web page.

<wl:conversation
   cid="-01233456789">
</wl:conversation>

The following table lists the attributes for a Conversation control.

Name Type Required Default Value Description

cid

String

Yes

none

Sets the CID for the contact with whom the signed-in user is conversing. Note that the $user value cannot be used in this context, since it is not possible to have a conversation with oneself.

display-pictures-enabled

Boolean

No

true

Sets whether the display pictures attribute is enabled.

group-sequential-messages

Boolean

No

true

Sets whether sequential messages should be grouped together.

timestamps-enabled

Boolean

No

true

Sets whether timestamps should be applied to messages.

on-conversation-created

Function Callback

No

none

Sets the event handler that is invoked when the Conversation instance is created. The on-conversation-created event is raised when a user starts a new conversation. The first parameter for the event handler is

Microsoft.Live.UI.Messenger.ConversationControl.conversationCreated.

on-message-received

Function Callback

No

none

Sets the event handler that is invoked when messages are received by the conversation. The on-message-received event is raised whenever a new message is received. The first parameter for the function is Microsoft.Live.Messenger.Conversation.

The application web site must supply a cascading style sheet: there is no default cascading style sheet for the Conversation control.

Show: