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

引用