GetNextDlgGroupItem 函数 (winuser.h)
检索一组控件中第一个控件的句柄,该控件位于 (或) 对话框中的指定控件之后。
语法
HWND GetNextDlgGroupItem(
[in] HWND hDlg,
[in, optional] HWND hCtl,
[in] BOOL bPrevious
);
参数
[in] hDlg
类型:HWND
要搜索的对话框的句柄。
[in, optional] hCtl
类型:HWND
要用作搜索起点的控件的句柄。 如果此参数为 NULL,则该函数使用对话框中的最后一个 (或第一个) 控件作为搜索的起点。
[in] bPrevious
类型: BOOL
指示函数如何搜索对话框中的控件组。 如果此参数为 TRUE,则函数在组中搜索上一个控件。 如果为 FALSE,则函数将搜索组中的下一个控件。
返回值
类型:HWND
如果函数成功,则返回值是控件组中上一个 (或下一) 控件的句柄。
如果函数失败,则返回值为 NULL。 要获得更多的错误信息,请调用 GetLastError。
注解
GetNextDlgGroupItem 函数按在对话框模板中创建控件 (顺序或反向顺序) 搜索控件。 组中的第一个控件必须具有 WS_GROUP 样式;组中的所有其他控件必须已连续创建,并且不得具有 WS_GROUP 样式。
搜索上一个控件时,函数将返回它找到的第一个控件,该控件可见且未禁用。 如果 由 hCtl 指定的控件具有 WS_GROUP 样式,则 函数会暂时反转搜索以查找具有 WS_GROUP 样式的第一个控件,然后按原始方向继续搜索,返回它找到的第一个可见且未禁用的控件;如果未找到此类控件,则返回 hCtl 。
搜索下一个控件时,函数将返回它找到的第一个控件,该控件是可见的、未禁用的,并且没有 WS_GROUP 样式。 如果它遇到具有 WS_GROUP 样式的控件,则函数将反向搜索,找到具有 WS_GROUP 样式的第一个控件,如果它可见且未禁用,则返回该控件。 否则,函数将恢复原始方向的搜索,并返回它找到的第一个控件,该控件是可见且未禁用的;如果未找到此类控件,则返回 hCtl 。
如果对组中下一个控件的搜索遇到 具有WS_EX_CONTROLPARENT 样式的窗口,则系统以递归方式搜索该窗口的子级。
要求
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | winuser.h (包括 Windows.h) |
Library | User32.lib |
DLL | User32.dll |
请参阅
概念性
引用