This interface encapsulates an Instant Messaging window with which instant messaging participants converse with each other.

The interface ID is D6B0E4C9-FAD6-4885-B271-0DC5A584ADF8 (IID_IMessengerConversationWnd).

Syntax

interface IMessengerConversationWnd : IMessengerWindow

Methods

The following table lists the methods exposed by the IMessengerConversationWnd interface.

Name Description

IMessengerConversationWnd::AddContact

Adds another user to the current conversation.

Scriptable.

IMessengerWindow::Close

(Inherited from IMessengerWindow.)

IMessengerWindow::Show

(Inherited from IMessengerWindow.)

Properties

This interface contains the following properties.

Name Description

IMessengerConversationWnd::Contacts

Retrieves a read-only collection of contacts in the conversation window.

Not scriptable.

IMessengerConversationWnd::History

Returns the text from the history of the conversation window.

Not scriptable.

IMessengerWindow::Close

(Inherited from IMessengerWindow.)

IMessengerWindow::Height

(Inherited from IMessengerWindow.)

IMessengerWindow::HWND

(Inherited from IMessengerWindow.)

IMessengerWindow::IsClosed

(Inherited from IMessengerWindow.)

IMessengerWindow::Left

(Inherited from IMessengerWindow.)

IMessengerWindow::Property

(Inherited from IMessengerWindow.)

IMessengerWindow::Show

(Inherited from IMessengerWindow.)

IMessengerWindow::Top

(Inherited from IMessengerWindow.)

IMessengerWindow::Width

(Inherited from IMessengerWindow.)

Subclasses

The following table lists the subclasses exposed by the IMessengerConversationWnd interface.

Name Description

IMessengerConversationWndAdvanced

Messenger Conversation Window Advanced Interface.

Remarks

A messenger window is either the main application window or any child window owned by the main application window. Different options might apply. Most dialog boxes (for example, Add a Contact and Options) cannot be controlled using this interface. These dialog boxes are considered child windows of the main messenger application window. They can be started by invoking Office Communicator Automation API.

The main application window is active as long as the executable is running (even in the notification area). Use the IMessenger::Window property, which returns a pointer to a pointer to the IDispatch interface. However, if the application window was previously minimized to the notification area through the IMessengerWindow::Close method or user action, it might also be necessary to invoke the IMessengerWindow::Show method on the application window.

For the conversation window, use the IMessenger::InstantMessage method or its variants, for example IMessenger::StartVoice method, which returns a pointer to a pointer to the IDispatch interface on a new or existing IMessengerWindow object.

To reference an existing MessengerWindow, use the return value of the methods used to invoke the window, such as the IMessenger::InstantMessage method or its variants.

Inheritance Hierarchy

IDispatch

   IMessengerWindow

      IMessengerConversationWnd

Requirements

Client

Requires Microsoft DirectX 9.0, C Runtime libraries (msvcm80.dll) on Microsoft Windows© Vista, Microsoft Windows XP Service Pack 1 (SP1) or later, or Microsoft Windows 2000 with Service Pack 4 (SP4). Any Communicator-imposed restrictions apply. .

Server

Requires Microsoft Office Communications Server 2007, AV MCU (for Media Support), Media Relay (for NAT/Firewall traversal) on Microsoft Office Communications Server 2007.

Product

Microsoft Office Communicator 2007 Automation API

IDL file

Msgrua.idl

See Also

Reference

Interfaces