getDlgCtrlID 函式 (winuser.h)

擷取指定控制項的識別碼。

語法

int GetDlgCtrlID(
  [in] HWND hWnd
);

[in] hWnd

類型： HWND

控制項的控制碼。

類型： int

如果函式成功，則傳回值是控制項的識別碼。

如果此函式失敗，則傳回值為零。例如 ，hwndCtl 參數的值無效，會導致函式失敗。若要取得擴充的錯誤資訊，請呼叫 GetLastError。

GetDlgCtrlID 接受子視窗控制碼，以及對話方塊中控制項的控制碼。應用程式會在呼叫CreateWindow 或 CreateWindowEx函式時，將識別碼值指派給hmenu參數，以在建立視窗時設定子視窗的識別碼。

雖然如果hwndCtl是最上層視窗的控制碼，GetDlgCtrlID可能會傳回值，但最上層視窗不能有識別碼，因此這類傳回值永遠不會有效。

如需範例，請參閱初始化對話方塊。


最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平台	Windows
標頭	winuser.h (包括 Windows.h)
程式庫	User32.lib
Dll	User32.dll
API 集合	ext-ms-win-ntuser-dialogbox-l1-1-0 (在 Windows 8)

概念

參考