GetNextWindow
The GetNextWindow
function retrieves the handle of the next or previous window in the Z order. The next window is below the
specified window; the previous window is above. If the specified window is a
topmost window, the function retrieves the handle of the next (or previous)
topmost window. If the specified window is a top-level window, the function
retrieves the handle of the next (or previous) top-level window. If the specified
window is a a child window, the function searches for a handle of the next (or
previous) child window.
HWND GetNextWindow(
|
HWND hWnd, |
// handle of
current window |
|
UINT wCmd |
// direction flag |
|
); |
|
Parameters
hWnd
Identifies a
window. The window handle retrieved is relative to this window, based on the
value of the wCmd parameter.
wCmd
Specifies
whether the function returns the handle of the next window or of the previous
window. This parameter can be either of the following values:
|
Value |
Meaning |
|
GW_HWNDNEXT |
Returns the
handle of the window below the given window. |
|
GW_HWNDPREV |
Returns the
handle of the window above the given window. |
Return Values
If the
function succeeds, the return value is the handle of the next (or previous)
window. If there is no next (or previous) window, the return value is NULL. To
get extended error information, call GetLastError.
Remarks
Using this
function is the same as calling the GetWindow function with the
GW_HWNDNEXT or GW_HWNDPREV flag set.
See Also