getDlgItem 函数 (winuser.h)
检索指定对话框中控件的句柄。
语法
HWND GetDlgItem(
[in, optional] HWND hDlg,
[in] int nIDDlgItem
);
参数
[in, optional] hDlg
类型:HWND
包含控件的对话框的句柄。
[in] nIDDlgItem
类型: int
要检索的控件的标识符。
返回值
类型:HWND
如果函数成功,则返回值为指定控件的窗口句柄。
如果函数失败,则返回值为 NULL,指示无效的对话框句柄或不存在控件。 要获得更多的错误信息,请调用 GetLastError。
注解
可以将 GetDlgItem 函数用于任何父子窗口对,而不仅仅是对话框。 只要 hDlg 参数指定父窗口,并且子窗口具有唯一标识符 (由创建子窗口) 的 CreateWindow 或 CreateWindowEx 函数中的 hMenu 参数指定,GetDlgItem 将返回子窗口的有效句柄。
示例
有关示例,请参阅 初始化对话框。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | winuser.h (包括 Windows.h) |
Library | User32.lib |
DLL | User32.dll |
API 集 | 在 Windows 8) 中引入的 ext-ms-win-ntuser-dialogbox-l1-1-0 ( |
请参阅
概念性
引用