Freigeben über


GetDlgCtrlID-Funktion (winuser.h)

Ruft den Bezeichner des angegebenen Steuerelements ab.

Syntax

int GetDlgCtrlID(
  [in] HWND hWnd
);

Parameter

[in] hWnd

Typ: HWND

Ein Handle für das Steuerelement.

Rückgabewert

Typ: int

Wenn die Funktion erfolgreich ist, ist der Rückgabewert der Bezeichner des Steuerelements.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Ein ungültiger Wert für den hwndCtl-Parameter führt beispielsweise dazu, dass die Funktion fehlschlägt. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

GetDlgCtrlID akzeptiert untergeordnete Fensterhandles sowie Handles von Steuerelementen in Dialogfeldern. Eine Anwendung legt den Bezeichner für ein untergeordnetes Fenster fest, wenn sie das Fenster erstellt, indem sie dem hmenu-Parameter beim Aufrufen der CreateWindow - oder CreateWindowEx-Funktion den Bezeichnerwert zuweisen.

Obwohl GetDlgCtrlID einen Wert zurückgeben kann, wenn hwndCtl ein Handle für ein Fenster der obersten Ebene ist, können Fenster der obersten Ebene keine Bezeichner aufweisen, und ein solcher Rückgabewert ist nie gültig.

Beispiele

Ein Beispiel finden Sie unter Initialisieren eines Dialogfelds.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile winuser.h (einschließlich Windows.h)
Bibliothek User32.lib
DLL User32.dll
APIs ext-ms-win-ntuser-dialogbox-l1-1-0 (in Windows 8 eingeführt)

Siehe auch

Konzept

Createwindow

Createwindowex

Dialogfelder

GetDlgItem

Referenz