IMessengerWindow::Left Property

Deprecated. Sets or retrieves the left screen position of a Messenger window, in pixels.

Syntax

HRESULT IMessengerWindow::get_Left(LONG *plLeft);
HRESULT IMessengerWindow::put_Left(LONG lLeft);

Parameters

  • plLeft
    Pointer to a variable of type LONG that receives the screen position of the left edge of the Messenger window in pixels.
  • lLeft
    LONG that specifies the screen position of the left edge of the Messenger window in pixels.

Return Value

Returns one of the following values: 

S_OK Success.
RPC_X_NULL_REF_POINTER plLeft is a NULL pointer.
E_FAIL Could not get window handle.
E_NOTIMPL Cannot be accessed through scripting.

Remarks

If the Messenger window is minimized, the value retrieved will appear to be out of range (>= -32000). If the Messenger window is closed through application programming interface (API) or user action, this method fails to get a value.

If this method called on the IMessengerWindow object of the parent application's Messenger window, it returns the left screen position value of the parent application window.

There is no bounds-checking on input values for lLeft. Negative integer values are accepted, but the window will go no further off the left side than half its width.

Note  This property is not available for scripting languages.

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