IMessengerWindow::Height property
[Height is no longer available for use as of Windows Vista. See Windows Messenger for more information.]
Sets or retrieves the height of a Messenger window.
This property is read/write.
Syntax
HRESULT put_Height(
LONG lHeight
);
HRESULT get_Height(
[retval] LONG *plHeight
);
Property value
LONG that sets the height of the Messenger window in pixels.
Error codes
Returns one of the following values.
| Name | Meaning |
|---|---|
|
Success. |
|
plHeight is a NULL pointer. |
|
Attempted to set window to zero or negative width. |
|
Could not get window handle. |
|
Cannot be accessed through scripting. |
Remarks
The following table lists error codes returned by this method.
| Error Code | Meaning |
|---|---|
| 0x80004001 | Cannot be accessed through scripting. |
| 0x80004005 | Messenger application window or conversation window has been closed either through user action or the method that launched the window. |
| 0x80070057 | Attempted to set window to zero or negative height. |
If the Messenger window is closed (only available from the taskbar), not responding, or if the HWND could not be found, this method will fail.
Note
This property is not 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 Form_Load()
Text_Top.Text = CStr(MsgrWindow.Top)
Text_Height.Text = CStr(MsgrWindow.Height)
Text_Left.Text = CStr(MsgrWindow.Left)
Text_Width.Text = CStr(MsgrWindow.Width)
End Sub
Requirements
| End of client support |
Windows XP |
| End of server support |
Windows Server 2003 |
| Header |
|
| IDL |
|
| DLL |
|