IsDlgButtonChecked-Funktion (winuser.h)

  • Artikel

Die IsDlgButtonChecked-Funktion bestimmt, ob ein Schaltflächensteuerelement aktiviert ist oder ob ein Schaltflächensteuerelement mit drei Status aktiviert, deaktiviert oder unbestimmt ist.

Syntax

UINT IsDlgButtonChecked(
  [in] HWND hDlg,
  [in] int  nIDButton
);

Parameter

[in] hDlg

Typ: HWND

Ein Handle für das Dialogfeld, das das Schaltflächensteuerelement enthält.

[in] nIDButton

Typ: int

Der Bezeichner des Schaltflächensteuerelements.

Rückgabewert

Typ: UINT

Der Rückgabewert einer Schaltfläche, die mit den Formatvorlagen BS_AUTOCHECKBOX, BS_AUTORADIOBUTTON, BS_AUTO3STATE, BS_CHECKBOX, BS_RADIOBUTTON oder BS_3STATE erstellt wurde, kann einer der Werte in der folgenden Tabelle sein. Wenn die Schaltfläche eine andere Formatvorlage aufweist, ist der Rückgabewert 0.

Rückgabecode Beschreibung
BST_CHECKED
 Die Schaltfläche ist aktiviert.
BST_INDETERMINATE
 Die Schaltfläche befindet sich in einem unbestimmten Zustand (gilt nur, wenn die Schaltfläche über das BS_3STATE - oder BS_AUTO3STATE-Format verfügt).
BST_UNCHECKED
 Die Schaltfläche ist nicht aktiviert.

Hinweise

Die IsDlgButtonChecked-Funktion sendet eine BM_GETCHECK Nachricht an das angegebene Schaltflächensteuerelement.

Beispiele

Ein Beispiel finden Sie im Abschnitt "Erstellen eines moduslosen Dialogfelds" unter Verwenden von Dialogfeldern.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [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)

Weitere Informationen

CheckDlgButton