IMessengerWindow::Show Method

  • Article

Deprecated. Sets the visibility status of a Messenger window.

Syntax

HRESULT Show(VOID);

Return Value

Returns one of the following values: 

S_OK Success. The window might already have been in that visibility state, in which case no separate code is returned.
E_FAIL Window instance destroyed.

Remarks

This method is generally called in cases in which IMessengerWindow::IsClosed returns TRUE. Calling IMessengerWindow::Show will redisplay the Messenger application window or a conversation window (depending on the type of window to which the MessengerWindow object corresponds).

If the last state of the window was minimized by user action, then the window will become both visible and drawn to the last default sizing. A minimized window is the only scenario in which calling IMessengerWindow::Show on a conversation rather than main application window would be useful. Had the conversation window been previously closed, then the object itself would have disappeared. Calling the IMessengerWindow::Show method, or at least verifying that IMessengerWindow::IsClosed does not return TRUE, is a prerequisite to calling a number of other automation interfaces that require a valid window handle. For example, calling IMessengerWindow::Left while the window is closed will return E_FAIL as the HRESULT. The visibility of the Messenger application window is not parallel to the Visible properties and methods implemented in other application automation interfaces, such as the Microsoft Office automation APIs. When the Messenger application window is closed, it is not just sent and processed in the background. A closed Messenger application is sent to the background on the process level (in the notification area), not just on a windowing or display level.

Note  This method is available for scripting languages.

Important  IMessengerWindow::Show is no longer available in Windows Vista. See Windows Messenger for more information.