Button_GetCheck Makro (windowsx.h)

Ruft den Kontrollkästchenstatus eines Optionsfelds oder Kontrollkästchens ab. Sie können dieses Makro verwenden oder die BM_GETCHECK Nachricht explizit senden.

Syntax

LRESULT Button_GetCheck(
   HWND hwndCtl
);

Parameter

hwndCtl

Typ: HWND-

Ein Handle für das Schaltflächensteuerelement.

Rückgabewert

Typ: LRESULT-

Der Rückgabewert einer Schaltfläche, die mit der BS_AUTOCHECKBOX, BS_AUTORADIOBUTTON, BS_AUTO3STATE, BS_CHECKBOX, BS_RADIOBUTTONoder BS_3STATE Formatvorlage erstellt wurde, kann eine der folgenden Sein:

Rückgabecode Beschreibung
BST_CHECKED Die Schaltfläche ist aktiviert.
BST_INDETERMINATE Die Schaltfläche ist grau dargestellt und gibt einen unbestimmten Zustand an (gilt nur, wenn die Schaltfläche über die BS_3STATE oder BS_AUTO3STATE Formatvorlage verfügt).
BST_UNCHECKED Die Schaltfläche wird gelöscht.

Bemerkungen

Wenn die Schaltfläche eine andere Formatvorlage als die aufgelisteten hat, ist der Rückgabewert null.

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Windows Vista [nur Desktop-Apps]
mindestens unterstützte Server- Windows Server 2003 [Nur Desktop-Apps]
Zielplattform- Fenster
Header- windowsx.h