Freigeben über


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

Createwindow

Createwindowex

Dialogfelder

GetDlgItemInt

GetDlgItemText

Referenz