GetDlgItem function

Retrieves a handle to a control in the specified dialog box.

功能：获得指定对话框上面某个控件的句柄

C++

Copy

HWND WINAPI GetDlgItem(
_In_opt_  HWND hDlg,
_In_      int nIDDlgItem
);

Parameters

参数

hDlg [in, optional]

Type: HWND

A handle to the dialog box that contains the control.

第一个参数：（控件所在的）对话框的句柄

nIDDlgItem [in]

Type: int

The identifier of the control to be retrieved.

第二个参数：需要检索的控件的ID号

Return value

返回值

Type: HWND

If the function succeeds, the return value is the window handle of the specified control.

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

If the function fails, the return value is NULL, indicating an invalid dialog box handle or a nonexistent control. To get extended error information, call GetLastError.

如果函数执行失败，返回值为NULL，表示无效的对话框句柄（即第一个参数值不对）或者控件不存在。若需要获得详细的错误信息，请调用函数GetLastError.

Remarks

备注

You can use the GetDlgItem function with any parent-child window pair, not just with dialog boxes. As long as the hDlg parameter specifies a parent window and the child window has a unique identifier (as specified by the hMenu parameter in the CreateWindow or CreateWindowEx function that created the child window), GetDlgItem returns a valid handle to the child window.

你不仅可以在对话框中使用GetDlgItem函数，也可以在 parent-child window pair（亲子窗口对？窗口中的窗口）中使用此函数。只要hDlg参数（第一个参数）指定了父窗口，且子窗口有唯一的ID号（此子窗口通常是通过函数CreateWindow 或 CreateWindowEx而创建的，而此窗口的ID号通常也就是上述两个函数中的参数hMenu）（理解得对不？）。

Examples

For an example, see Initializing a Dialog Box.

Requirements

Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Header	Winuser.h (include Windows.h)
Library	User32.lib
DLL	User32.dll