Share via


IMessengerWindow interface

[IMessengerWindow is no longer available for use as of Windows Vista. See Windows Messenger for more information.]

Do not use. The automation interface for a Messenger window.

Members

The IMessengerWindow interface inherits from the IDispatch interface. IMessengerWindow also has these types of members:

Methods

The IMessengerWindow interface has these methods.

Method Description
Close Closes a Messenger window. If the window is a conversation window, terminates any sessions contained in it.
Show Sets the visibility status of a Messenger window.

Properties

The IMessengerWindow interface has these properties.

Property Access type Description
Height
Sets or retrieves the height of a Messenger window.
HWND
Read-only
Retrieves a window handle to a Messenger window.
IsClosed
Read-only
Retrieves a Boolean value that indicates the open or closed state of the window.
Left
Sets or retrieves the left screen position of a Messenger window, in pixels.
Property
Sets or retrieves the conversation window properties.
Top
Sets or retrieves the vertical position of a Messenger window relative to the screen, in pixels.
Width
Sets or retrieves the horizontal dimension of a Messenger window, in pixels.

Remarks

A Messenger window is either the main application window or any window opened by the main application window. Different API options can apply. Most dialog boxes (for example, Add a Contact and Options) cannot be controlled through the MessengerWindow APIs. These dialog boxes are considered child windows of the main Messenger application window. They can be launched by invoking Windows Messenger APIs.

The main application window is active as long as the executable is running (even in the notification area). Use the 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 Close or user action, it may also be necessary to invoke the Show method on the application window.

For the conversation window, use the InstantMessage method or its variants (StartVoice, SendFile, Page, InviteApp), 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 InstantMessage or its variants.

Requirements

Minimum supported client
Windows XP [desktop apps only]
Minimum supported server
Windows Server 2003 [desktop apps only]
End of client support
Windows XP
End of server support
Windows Server 2003
Product
Messenger 4.0
Header
Msgrua.h
IDL
Msgrua.idl
DLL
Msgsc.dll