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
Referenz