Important Notice
The pages on this site contain documentation for very old MS-DOS software,
purely for historical purposes.
If you're looking for up-to-date documentation, particularly for programming,
you should not rely on the information found here, as it will be woefully
out of date.
WinQueryWindow (1.2)
◄Function Group► ◄Overview► ◄Changes► ◄Up► ◄Next► ◄Previous►
────────────────────────────────────────────────────────────────────────────
#define INCL_WINMESSAGEMGR
HWND WinQueryWindow(hwnd, cmd, fLock)
HWND hwnd; /* handle of the window */
SHORT cmd; /* which window to retrieve */
BOOL fLock; /* lock/unlock flag */
The WinQueryWindow function retrieves the handle of a window that has a
specified relationship to a specified window.
If WinQueryWindow is used to enumerate windows of other threads, it is not
guaranteed that all the windows are enumerated, because the Z ordering of
the windows may change during the enumeration. The WinGetNextWindow function
must be used for this purpose.
Parameter Description
────────────────────────────────────────────────────────────────────────────
hwnd Identifies a window. The window handle retrieved is relative to
this window, based on the value in the cmd parameter.
cmd Specifies which window to retrieve. The following are the
possible values:
Value Meaning
─────────────────────────────────────────────────────────────────
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 the window.
QW_PARENT Parent of window; HWND_OBJECT if object window.
QW_NEXTTOP Next main window in the enumeration order defined
for the ALT+ESCAPE function of the user
interface.
QW_PREVTOP Previous main window, in the enumeration order
defined by QW_NEXTTOP.
QW_FRAMEOWNER Returns the owner of hwnd, normalized so that it
shares the same parent as hwnd.
fLock This parameter is ignored by MS OS/2 versions 1.2 and later.
Return Value
The return value is the handle of the window related to the window
identified by the hwnd parameter.
See Also
WinGetNextWindow, WinLockWindow
♦