GetNextDlgTabItem
The GetNextDlgTabItem
function retrieves the handle of the first control that has the WS_TABSTOP
style that precedes (or follows) the specified control.
HWND GetNextDlgTabItem(
|
HWND hDlg, |
// handle of dialog
box |
|
HWND hCtl, |
// handle of known
control |
|
BOOL bPrevious |
// direction flag |
|
); |
|
Parameters
hDlg
Identifies
the dialog box to be searched.
hCtl
Identifies
the control to be used as the starting point for the search. If this parameter
is NULL, the function uses the last (or first) control in the dialog box as the
starting point for the search.
bPrevious
Specifies 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 Values
If the
function succeeds, the return value is the window handle of the previous (or
next) control that has the WS_TABSTOP style set.
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.
See Also