View source for WinQueryWindow

This function ''returns the handle of a window that has a specified relationship to a specified window''.

==Syntax==
 WinQueryWindow(hwnd, lCode)

==Parameters==
;hwnd ([[HWND]]) - Input: Handle of window to query.
;lCode ([[LONG]]) - Input: Type of window information to return.
:;QW_NEXT
::Next window in z-order (window below).
:;QW_PREV
::Previous window in z-order (window above).
:;QW_TOP
::Topmost child window.
:;QW_BOTTOM
::Bottommost child window.
:;QW_OWNER
::Owner of window.
:;QW_PARENT
::Parent of window.
:;QW_NEXTTOP
::Returns the next window of the owner window hierarchy subject to their z-ordering. The enumeration order is: 1. Owned windows in z-order. 2. Next z-ordered window's owned windows. 3. Hierarchy of windows with the same owner, repeated up the owner tree. 4. Hierarchy of unowned windows.
:;QW_PREVTOP
::Returns the previous main window in the QW_NEXTTOP enumeration order.
:;QW_FRAMEOWNER
::Returns the normalized owner of ''hwnd'' (same parent if applicable).
;hwndRelated ([[HWND]]) - Returns: Handle of the related window.

==Returns==
;hwndRelated (HWND) - returns :Handle of window related to ''hwnd''.

==Remarks==
When enumerating windows of other threads, it's not guaranteed all windows will be found due to potential z-order changes. [[WinGetNextWindow]] should be used for reliable enumeration.

When called with QW_OWNER or QW_PARENT and the desktop window is reached, the return value is [[WinQueryDesktopWindow]](hab, NULLHANDLE), not HWND_DESKTOP.

When called with QW_PARENT for an object window, the return value is the handle of the object window associated with the desktop window, as returned by [[WinQueryObjectWindow]].

==Errors==
Possible returns from [[WinGetLastError]]:
:* PMERR_INVALID_HWND (0x1001) - An invalid window handle was specified.
:* PMERR_PARAMETER_OUT_OF_RANGE (0x1003) - The value of ''lCode'' was not within the valid range.

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

HWND    hwnd;        /* Handle of window to query. */
LONG    lCode;       /* Type of window information. */
HWND    hwndRelated; /* Window handle. */

hwndRelated = WinQueryWindow(hwnd, lCode);
</PRE>
This example shows how to get the frame window handle from the client window handle.
<Pre>
#define INCL_WINWINDOWMGR
#define INCL_WINACCELERATORS
#include <OS2.H>

HACCEL haccel;
HWND hwndFrame, hwndClient; /* window handles. */
HAB hab;                   /* anchor block.   */

hwndFrame = WinQueryWindow(hwndClient,
                           QW_PARENT); /* get handle of parent, */
                                      /* which is frame window. */
</PRE>

==Related Functions==
* [[WinBeginEnumWindows]]
* [[WinEndEnumWindows]]
* [[WinEnumDlgItem]]
* [[WinGetNextWindow]]
* [[WinIsChild]]
* [[WinMultWindowFromIDs]]
* [[WinSetOwner]]
* [[WinSetParent]]
[[Category:Win]]