GetNextDlgTabItem (Windows CE 5.0)

Send Feedback

This function retrieves the handle to the first control with the WS_TABSTOP style that precedes or follows the specified control.

HWNDGetNextDlgTabItem( HWNDhDlg, HWNDhCtl, BOOLbPrevious);

Parameters

  • hDlg
    [in] Handle to the dialog box to be searched.
  • hCtl
    [in] Handle to 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
    [in] Boolean that 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

The window handle of the previous or next control that has the WS_TABSTOP style set indicates success. NULL indicates failure. 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.

Requirements

OS Versions: Windows CE 1.0 and later.
Header: Winuser.h.
Link Library: Dlgmgr.lib.

See Also

GetDlgItem | GetNextDlgGroupItem | Dialog Boxes Functions

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.