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

请参阅

概念性

对话框

GetNextDlgTabItem

引用