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