Microsoft.Live.Messenger Na ...


Windows Live Messenger Web Toolkit Class Reference
Conversation Class

Represents a conversation between two or more contacts.

Script:  http://www.wlmessenger.net/api/3.5/loader.js
Feature:  Messenger.Core
Namespace:  Microsoft.Live.Messenger
 
Cc299013.alert_note(en-us,MSDN.10).gifNote

The Windows Live Messenger Web Toolkit is built using the Microsoft AJAX Library. Microsoft AJAX exposes a type system that enables you to add object-oriented capabilities to your JavaScript code. To learn more about creating, instantiating and deriving from classes, visit Creating Custom Client Script by Using the Microsoft AJAX Library.

Syntax

JavaScript
Microsoft.Live.Messenger.Conversation = function();

Type.registerClass(
    'Microsoft.Live.Messenger.Conversation',
    null,
    Microsoft.Live.Messenger.INotifyPropertyChanged,
    Sys.IDisposable);
C# (Script#)
public class Conversation : INotifyPropertyChanged, 
    IDisposable
Remarks

A conversation is a logical container for communication between two or more contacts. As a user and contact communicate with one another, text messages and typing indicators are transmitted to each participant of the conversation. Applications commonly render these communications in a conversation window which has an input area and a history of communications between the user and contact.

To create a conversation with a Contact, use the Create(Contact) method of the Conversations property on User. Once a Conversation has been created, a TextMessage can be sent using the SendMessage(Message) method of conversation.

The CollectionChanged event of the Conversations property on User is raised when conversations are added to the collection. This event should be handled to detect when the user has been invited to conversations by other contacts.

The MessageReceived event is raised whenever messages from other participants of the conversation are delivered to the user. The event should be handled to detect messages that have been received.

To add more participants to a conversation, the InviteContact(Contact) method can be used.

Inheritance Hierarchy

Object
  Microsoft.Live.Messenger..::.Conversation
Version Information

Windows Live Messenger Web Toolkit

Supported in: 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.5, Firefox 3.0, Firefox 2.0, Firefox 1.5, Chrome 2.0, Chrome 1.0, Safari 4.0, Safari 3.0

See Also

Page view tracker