GetNextDlgTabItem function (winuser.h)
Retrieves a handle to the first control that has the WS_TABSTOP style that precedes (or follows) the specified control.
Syntax
HWND GetNextDlgTabItem(
[in] HWND hDlg,
[in, optional] HWND hCtl,
[in] BOOL bPrevious
);
Parameters
[in] hDlg
Type: HWND
A handle to the dialog box to be searched.
[in, optional] hCtl
Type: HWND
A handle to the control to be used as the starting point for the search. If this parameter is NULL, the function fails.
[in] bPrevious
Type: BOOL
Indicates how the function is to search the dialog box. If this parameter is TRUE, the function searches for the previous control in the dialog box. If this parameter is FALSE, the function searches for the next control in the dialog box.
Return value
Type: HWND
If the function succeeds, the return value is the window handle of the previous (or next) control that has the WS_TABSTOP style set.
If the function fails, the return value is NULL. To get extended error information, call GetLastError.
Remarks
The GetNextDlgTabItem function searches controls in the order (or reverse order) they were created in the dialog box template. The function returns the first control it locates that is visible, not disabled, and has the WS_TABSTOP style. If no such control exists, the function returns hCtl.
If the search for the next control with the WS_TABSTOP style encounters a window with the WS_EX_CONTROLPARENT style, the system recursively searches the window's children.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 2000 Professional [desktop apps only] |
| Minimum supported server | Windows 2000 Server [desktop apps only] |
| Target Platform | Windows |
| Header | winuser.h (include Windows.h) |
| Library | User32.lib |
| DLL | User32.dll |
| API set | ext-ms-win-ntuser-dialogbox-l1-1-2 (introduced in Windows 10, version 10.0.10240) |
See also
Conceptual
Reference