GetNextDlgGroupItem

  HWND GetNextDlgGroupItem(hwndDlg, hCtl, bPrevious)    
  HWND hwndDlg; /* handle of dialog box */
  HWND hCtl; /* handle of control */
  BOOL bPrevious; /* direction flag */

This function searches for the next (or previous) control within a group of controls in the dialog box identified by the hwndDlg parameter. A group of controls consists of one or more controls with WS_GROUP style.

Parameters

hwndDlg

Identifies the dialog box being searched.

hCtl

Identifies the control in the dialog box where the search starts.

bPrevious

Specifies how the function is to search the group of controls in the dialog box. If the bPrevious parameter is nonzero, the function searches for the previous control in the group. If bPrevious is zero, the function searches for the next control in the group.

Return Value

The return value identifies the next or previous control in the group.

Comments

If the current item is the last item in the group and bPrevious is zero, the GetNextDlgGroupItem function returns the window handle of the first item in the group. If the current item is the first item in the group and bPrevious is nonzero, GetNextDlgGroupItem returns the window handle of the last item in the group.

See Also

GetNextDlgTabItem