GetNextDlgGroupItem函数检索对话框中指定控件之前(或后)的一组控件中的第一个控件的句柄。
HWND GetNextDlgGroupItem(
HWND 【hDlg】, | //对话框的句柄 |
HWND 【HCTL】, | //控制柄 |
BOOL 【bPrevious】 | //方向标志 |
); |
参数
【hDlg】
标识正在搜索的对话框。
【HCTL】
标识要用作搜索起点的控件。如果此参数为NULL,该函数将使用对话框中的最后一个(或第一个)控件作为搜索的起始点。
【bPrevious】
指定该函数如何在对话框中搜索控件组。如果此参数为TRUE,则该函数将搜索组中之前的控件。如果为FALSE,则该函数将搜索组中的下一个控件。
返回值
如果GetNextDlgGroupItem成功,则返回值是控件组中之前(或下一个)控件的句柄。
备注
GetNextDlgGroupItem函数按照在对话框模板中创建的顺序(或相反的顺序)来搜索控件。组中的第一个控件必须具有WS_GROUP样式;必须连续创建组中的所有其他控件,并且必须【不】具有WS_GROUP样式。
当搜索上一个控件时,该函数返回它所定位的第一个控件是可见的,而不是禁用。如果【HCTL】给出的控件具有WS_GROUP样式,则该函数临时反转搜索以定位具有WS_GROUP样式的第一个控件,然后在原始方向上恢复搜索,返回其可见且未禁用的第一个控件,或返回【// ditms】,如果没有找到此类控件。
当搜索下一个控件时,该函数返回其可见,不被禁用的第一个控件,并且【不】具有WS_GROUP样式。如果遇到具有WS_GROUP样式的控件,则该函数将反转搜索,找到具有WS_GROUP样式的第一个控件,如果该对象可见且未被禁用则返回此控件。否则,该函数将恢复原始方向的搜索,并返回其可见和未禁用的第一个控件,否则返回【HCTL】,如果没有找到此类控件。
也可以看看