Freigeben über


Button_GetState Makro (windowsx.h)

Ruft den Status einer Schaltfläche oder eines Kontrollkästchens ab. Sie können dieses Makro verwenden oder die BM_GETSTATE Nachricht explizit senden.

Syntax

LRESULT Button_GetState(
   HWND hwndCtl
);

Parameter

hwndCtl

Typ: HWND-

Ein Handle für das Schaltflächensteuerelement.

Rückgabewert

Typ: LRESULT-

Der Rückgabewert gibt den aktuellen Status der Schaltfläche an. Es handelt sich um eine Kombination der folgenden Werte:

Rückgabecode Beschreibung
BST_CHECKED Die Schaltfläche ist aktiviert.
BST_DROPDOWNPUSHED Windows Vista. Die Schaltfläche befindet sich im Dropdownzustand. Gilt nur, wenn die Schaltfläche die TBSTYLE_DROPDOWN Formatvorlage aufweist.
BST_FOCUS Die Schaltfläche hat den Tastaturfokus.
BST_HOT Die Taste ist heiß; d. h., die Maus zeigt darauf.
BST_INDETERMINATE Der Zustand der Schaltfläche ist unbestimmt. Gilt nur, wenn die Schaltfläche das BS_3STATE oder BS_AUTO3STATE Format aufweist.
BST_PUSHED Die Schaltfläche wird im Gedrückten Zustand angezeigt.
BST_UNCHECKED Kein spezieller Zustand. Entspricht 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

Siehe auch

Button_GetCheck

Button_SetState

Referenz-