GetDlgItem-Funktion (winuser.h)

Artikel
03/13/2024

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)