GetNextDlgGroupItem

Syntax

HWND GetNextDlgGroupItem(hDlg,hCtl,bPrevious)

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

Parameter Type/Description  

hDlg HWND Identifies the dialog box being searched.  
hCtl HWND Identifies the control in the dialog box where the search starts.  
bPrevious BOOL Specifies how the function is to search the group of controls in the dialog box. If the bPrevious parameter is zero, the function searches for the previous control in the group. If bPrevious is nonzero, 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.