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 |
|
| IDL |
|
| DLL |
|