GetDlgCtrlID

Die GetDlgCtrlID -Funktion gibt die ID des angegebenen Steuerelements zurück.

Int GetDlgCtrlID) HWND  HwndCtl / / handle des Steuerelements);
 

Parameter

hwndCtl
Identifiziert das Steuerelement.

Rückgabewerte

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

Wenn die Funktion fehlschlägt, ist der Rückgabewert 0 (null). Ein ungültiger Wert für den Parameter HwndCtl wird beispielsweise die Funktion fehlschlagen verursachen. Rufen Sie Fehlerinformationen verlängert bekommen, GetLastError.

Bemerkungen

GetDlgCtrlID akzeptiert untergeordnete Fenster-Handles sowie Ziehpunkte von Steuerelementen in Dialogfeldern. Eine Anwendung legt den Bezeichner für ein untergeordnetes Fenster, wenn es das Fenster erstellt, indem Sie den ID-Wert zuweisen des Hmenu -Parameters beim Aufrufen der Funktion CreateWindow oder CreateWindowEx.

Obwohl GetDlgCtrlID einen Wert zurückgeben kann, wenn HwndCtl ein Fenster der obersten Ebene identifiziert, Fenster auf oberster Ebene können keine Bezeichner haben und nie ein Rückgabewert gültig ist.

Windows CE: Bezeichner sind nur gültig für untergeordnete Fenster.

Der Bezeichner kann festgelegt werden, indem sie in der CreateWindowEx -Funktion als hMenu -Parameter übergeben. Es kann auch festgelegt und abgerufen, indem die SetWindowLong und GetWindowLong Funktionen mit dem festgelegten zu GWL_ID nIndex -parameter.

QuickInfo

&Nbsp; Windows NT: Version 3.1 oder höher erforderlich.
Windows:Erfordert Windows 95 oder höher.
Windows CE:Version 1.0 oder höher benötigt.
Header:In winuser.h deklarierten.
Importieren Bibliothek:Verwenden Sie user32.lib.

Siehe auch

Übersicht über Dialogfelder, Dialogfeld Feld Funktionen, CreateWindow-Funktion, CreateWindowEx, GetDlgItem

Index