IMessengerWindow::IsClosed property
[IsClosed is no longer available for use as of Windows Vista. See Windows Messenger for more information.]
Retrieves a Boolean value that indicates the open or closed state of the window.
This property is read-only.
Syntax
HRESULT get_IsClosed(
[out, retval] VARIANT_BOOL *pBoolClose
);
Property value
Pointer to a VARIANT_BOOL that defines the open and closed state for the Messenger window with one of the following possible values.
Value | Meaning |
---|---|
|
Messenger window is closed. This means that it has no HWND or window handle either numerically or on a system level. Attempts to reference some Win32 functions against the window will fail. The client can continue to exist as a running executable and can potentially be seen in process lists and in minimized form in the notification area or system tray. |
|
Messenger application window is either visible or minimized and has a valid HWND or window handle. |
Error codes
Returns one of the following values.
Name | Meaning |
---|---|
|
Success. |
|
pBoolClose is a NULL pointer. |
Remarks
This method is useful when this interface is called against the Messenger application window. The method can be called against a conversation window, but will return FALSE for any case in which a valid MessengerWindow object existed to call the method against. If the conversation window that corresponds to the object had been closed by client action, then the object would have become unassigned and thrown an object reference error. A minimized window is considered to be closed or not closed based on the visibility settings through Show, Close, or equivalent user interface (UI) settings.
Note
This property is available for scripting languages.
Examples
The following Visual Basic example shows the use of this method.
Public WithEvents MsgrUIA As MessengerAPI.Messenger
Public MsgrWindow As MessengerAPI.IMessengerWindow
Private Sub Cmd_W_IsClosed_Click()
If MsgrWindow.IsClosed = True Then
MsgBox "Closed"
Else
MsgBox "Showed"
End If
End Sub
Requirements
End of client support |
Windows XP |
End of server support |
Windows Server 2003 |
Header |
|
IDL |
|
DLL |
|