GetNextDlgTabItem

2.x

HWND GetNextDlgTabItem(hwndDlg, hwndCtrl, fPrevious)
HWND hwndDlg;	/* handle of dialog box	*/
HWND hwndCtrl;	/* handle of known control	*/
BOOL fPrevious;	/* direction flag, */

The GetNextDlgTabItem function retrieves the handle of the first control that has the WS_TABSTOP style that precedes (or follows) the specified control.

Parameters

hwndDlg

Identifies the dialog box to be searched.

hwndCtrl

Identifies the control to be used as the starting point for the search.

fPrevious

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 Value

The return value is the window handle of the previous (or next) control that has the WS_TABSTOP style, if the function is successful.

Example

The following example retrieves the handle of the previous control that has the WS_TABSTOP style, relative to the control that has the input focus:

HWND hdlg;
HWND hwndControl;

hwndControl = GetNextDlgTabItem(hdlg, GetFocus(), TRUE);