Export (0) Print
Expand All

IMessengerWindow

This content is no longer actively maintained. It is provided as is, for anyone who may still be using these technologies, with no warranties or claims of accuracy with regard to the most recent product version or service release.

This interface defines the states and behaviors of a messenger window.

The interface ID is D6B0E4C8-FAD6-4885-B271-0DC5A584ADF8 (IID_IMessengerWindow).


interface IMessengerWindow : IDispatch

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

Name Description

IMessengerWindow::Close

Closes a messenger window. If the window is a conversation window, the call terminates any sessions contained in it.

Not scriptable.

IMessengerWindow::Show

Sets the visibility status of a messenger window.

Scriptable.

This interface contains the following properties.

Name Description

IMessengerWindow::Height

Sets or retrieves the height of a messenger window.

Not scriptable.

IMessengerWindow::HWND

Retrieves a window handle to a messenger window.

Not scriptable.

IMessengerWindow::IsClosed

Retrieves a Boolean value that indicates the open or closed state of the window.

Scriptable.

IMessengerWindow::Left

Sets or retrieves the left screen position of a messenger window, in pixels.

Not scriptable.

IMessengerWindow::Property

Not Implemented.

IMessengerWindow::Top

Sets or retrieves the vertical position of a messenger window relative to the screen, in pixels.

Not scriptable.

IMessengerWindow::Width

Sets or retrieves the horizontal dimension of a messenger window, in pixels.

Not scriptable.

The following table lists the subclass exposed by the IMessengerWindow interface.

Name Description

IMessengerConversationWnd

Encapsulates an Instant Messaging window with which instant messaging participants converse with each other.

A messenger window is either the main application window or any child window owned by the main application window. Different options can 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 one of its variants (for example, IMessenger::StartVoice method), which return a pointer to a pointer to the IDispatch interface on a new or existing MessengerWindow 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.

IDispatch

   IMessengerWindow

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

Community Additions

ADD
Show:
© 2014 Microsoft