WinQueryObjectWindow

This function returns the desktop object window handle.

Syntax

WinQueryObjectWindow(hwndDesktop)

Parameters

hwndDesktop (HWND) - input

Desktop-window handle.

HWND_DESKTOP

The desktop-window handle

Other

Specified desktop-window handle.

Returns

hwndObject (HWND) - returns

Object-window handle.

NULLHANDLE

Error occurred.

Errors

Possible returns from WinGetLastError

PMERR_INVALID_HWND (0x1001)

An invalid window handle was specified.

Remarks

Any window created as a descendant of hwndObject is an object window.

Example Code

Declaration:

#define INCL_WINWINDOWMGR /* Or use INCL_WIN, INCL_PM, */
#include <os2.h>

HWND    hwndDesktop;  /*  Desktop-window handle. */
HWND    hwndObject;   /*  Object-window handle. */

hwndObject = WinQueryObjectWindow(hwndDesktop);

This example calls WinQueryObjectWindow to return the desktop object window handle. All windows created as descendants of this object window-as in the example-will be object windows.

#define INCL_WINWINDOWMGR       /* Window Manager Functions     */
#include <os2.h>

HWND    hwndObject;     /* desktop object window                */
HWND    hwndObject1;    /* descendant object window             */
USHORT  WindowId;
hwndObject = WinQueryObjectWindow(HWND_DESKTOP);

/* create object window */
hwndObject1 = WinCreateWindow(hwndObject,  /* parent window     */
                       "NewClass",    /* class name             */
                       "new button",  /* window text            */
                       WS_VISIBLE,    /* window style           */
                       0, 0,          /* position (x,y)         */
                       200, 100,      /* size (width,height)    */
                       0L,            /* owner window           */
                       HWND_TOP,      /* sibling window         */
                       WindowId,      /* window id              */
                       NULL,          /* control data           */
                       NULL);         /* presentation parms     */