GetWindow
The GetWindow
function retrieves the handle of a window that has the specified relationship (Z
order or owner) to
the specified window.
HWND GetWindow(
|
HWND hWnd, |
// handle of original
window |
|
UINT uCmd |
// relationship
flag |
|
); |
|
Parameters
hWnd
Identifies a
window. The window handle retrieved is relative to this window, based on the
value of the uCmd parameter.
uCmd
Specifies the
relationship between the specified window and the window whose handle is to be
retrieved. This parameter can be one of the following values:
|
Value |
Meaning |
|
GW_CHILD |
The
retrieved handle identifies the child window at the top of the Z order, if
the specified window is a parent window; otherwise, the retrieved handle is
NULL. The function examines only child windows of the specified window. It
does not examine descendant windows. |
|
GW_HWNDFIRST |
The
retrieved handle identifies the window of the same type that is highest in
the Z order. If the specified window is a topmost window, the handle
identifies the topmost window that is highest in the Z order. If the
specified window is a top-level window, the handle identifies the top-level
window that is highest in the Z order. If the specified window is a child
window, the handle identifies the sibling window that is highest in the Z
order. |
|
GW_HWNDLAST |
The
retrieved handle identifies the window of the same type that is lowest in the
Z order. If the specified window is a topmost window, the handle identifies
the topmost window that is lowest in the Z order. If the specified window is
a top-level window, the handle identifies the top-level window that is lowest
in the Z order. If the specified window is a child window, the handle
identifies the sibling window that is lowest in the Z order. |
|
GW_HWNDNEXT |
The
retrieved handle identifies the window below the specified window in the Z order.
If the specified window is a topmost window, the handle identifies the
topmost window below the specified window. If the specified window is a
top-level window, the handle identifies the top-level window below the
specified window. If the specified window is a child window, the handle
identifies the sibling window below the specified window. |
|
GW_HWNDPREV |
The
retrieved handle identifies the window above the specified window in the Z
order. If the specified window is a topmost window, the handle identifies the
topmost window above the specified window. If the specified window is a
top-level window, the handle identifies the top-level window above the
specified window. If the specified window is a child window, the handle
identifies the sibling window above the specified window. |
|
GW_OWNER |
The
retrieved handle identifies the specified window s owner window, if any. |
Return Values
If the
function succeeds, the return value is a window handle. If no window exists
with the specified relationship to the specified window, the return value is
NULL. To get extended error information, call GetLastError.
See Also