getDlgItem 函式 (winuser.h)

發行項
03/13/2024

擷取指定對話框中控件的句柄。

語法

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)
程式庫	User32.lib
Dll	User32.dll
API 集合	ext-ms-win-ntuser-dialogbox-l1-1-0 (在 Windows 8) 中引進