The GetNextWindow function retrieves a handle to 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 a handle to the next (or previous) topmost window. If the specified window is a top-level window, the function retrieves a handle to the next (or previous) top-level window. If the specified window is a child window, the function searches for a handle to the next (or previous) child window.
Syntax
HWND GetNextWindow(
HWND hWnd,
UINT wCmd
);
Parameters
- hWnd
-
[in] Handle to a window. The window handle retrieved is relative to this window, based on the value of the wCmd parameter.
- wCmd
-
[in] Specifies whether the function returns a handle to the next window or of the previous window. This parameter can be either of the following values.
GW_HWNDNEXT- Returns a handle to the window below the given window.
GW_HWNDPREV- Returns a handle to the window above the given window.
Return Value
If the function succeeds, the return value is a handle to 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.
Function Information
| Minimum DLL Version | user32.dll |
|---|
| Header | Declared in Winuser.h, include Windows.h |
|---|
| Import library | User32.lib |
|---|
| Minimum operating systems |
Windows 95, Windows NT 3.1 |
|---|
See Also