getDlgItem 函数 (winuser.h)

检索指定对话框中控件的句柄。

语法

HWND GetDlgItem(
  [in, optional] HWND hDlg,
  [in]           int  nIDDlgItem
);

参数

[in, optional] hDlg

类型:HWND

包含控件的对话框的句柄。

[in] nIDDlgItem

类型: int

要检索的控件的标识符。

返回值

类型:HWND

如果函数成功,则返回值为指定控件的窗口句柄。

如果函数失败,则返回值为 NULL,指示无效的对话框句柄或不存在控件。 要获得更多的错误信息,请调用 GetLastError。

注解

可以将 GetDlgItem 函数用于任何父子窗口对,而不仅仅是对话框。 只要 hDlg 参数指定父窗口,并且子窗口具有唯一标识符 (由创建子窗口) 的 CreateWindowCreateWindowEx 函数中的 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 (

请参阅

概念性

CreateWindow

CreateWindowEx

对话框

GetDlgItemInt

GetDlgItemText

引用