GetDlgItem-Funktion (winuser.h)
Ruft ein Handle für ein Steuerelement im angegebenen Dialogfeld ab.
Syntax
HWND GetDlgItem(
[in, optional] HWND hDlg,
[in] int nIDDlgItem
);
Parameter
[in, optional] hDlg
Typ: HWND
Ein Handle für das Dialogfeld, das das Steuerelement enthält.
[in] nIDDlgItem
Typ: int
Der Bezeichner des abzurufenden Steuerelements.
Rückgabewert
Typ: HWND
Wenn die Funktion erfolgreich ist, ist der Rückgabewert das Fensterhandle des angegebenen Steuerelements.
Wenn die Funktion fehlschlägt, ist der Rückgabewert NULL, was ein ungültiges Dialogfeldhandle oder ein nicht vorhandenes Steuerelement angibt. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Hinweise
Sie können die GetDlgItem-Funktion mit jedem über-/untergeordneten Fensterpaar verwenden, nicht nur mit Dialogfeldern. Solange der hDlg-Parameter ein übergeordnetes Fenster angibt und das untergeordnete Fenster über einen eindeutigen Bezeichner verfügt (wie durch den hMenu-Parameter in der CreateWindow - oder CreateWindowEx-Funktion angegeben, die das untergeordnete Fenster erstellt hat), gibt GetDlgItem ein gültiges Handle an das untergeordnete Fenster zurück.
Beispiele
Ein Beispiel finden Sie unter Initialisieren eines Dialogfelds.
Anforderungen
| Anforderung | Wert |
|---|---|
| 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 (windows.h einschließen) |
| Bibliothek | User32.lib |
| DLL | User32.dll |
| APIs | ext-ms-win-ntuser-dialogbox-l1-1-0 (eingeführt in Windows 8) |
Siehe auch
Konzept
Referenz