BM_GETSTATE

Eine Anwendung sendet eine BM_GETSTATE Nachricht um zu bestimmen, den Zustand der Kontrollkästchen oder eine Schaltfläche.

BM_GETSTATE wParam = 0;     / / nicht benutzt; muss 0 (null) lParam = 0;     / / nicht benutzt; NULL muss sein 

 

Parameter

Diese Nachricht hat keine Parameter.

Rückgabewerte

Der Rückgabewert gibt den aktuellen Status der Schaltfläche. Sie können die folgenden Bitmasken verwenden, zum Extrahieren von Informationen über den Zustand:

Wert Bedeutung
0x0003 Gibt den Aktivierungszustand (Optionsfelder und Kontrollkästchen nur). Der Wert BST_UNCHECKED gibt an, dass die Schaltfläche deaktiviert ist; ein BST_CHECKED gibt an, dass die Schaltfläche aktiviert wird. Ein Optionsfeld wird überprüft, wenn es einen Punkt enthält; ein Kontrollkästchen ist aktiviert, wenn es einen x enthält. Der Wert BST_INDETERMINATE gibt der Aktivierungszustand ist unbestimmt (gilt nur, wenn die Schaltfläche das Format BS_3STATE oder BS_AUTO3STATE hat). Ein drei-Status-Kontrollkästchen ist deaktiviert, wenn sein Zustand unbestimmt ist.
BST_CHECKED Gibt an, dass die Schaltfläche aktiviert wird.
BST_FOCUS Gibt den Fokuszustand. Ein Wert ungleich NULL zeigt an, dass die Schaltfläche den Tastaturfokus besitzt.
BST_INDETERMINATE Gibt an, dass die Schaltfläche abgeblendet ist, weil die Zustände der Schaltfläche unbestimmt ist. Dieser Wert gilt nur, wenn die Schaltfläche das Format BS_3STATE oder BS_AUTO3STATE hat.
BST_PUSHED Gibt den Zustand der Höhepunkt. Ein Wert ungleich NULL zeigt an, dass die Schaltfläche hervorgehoben ist. Eine Schaltfläche wird automatisch markiert, wenn der Benutzer positioniert den Cursor darüber und drückt die linke Maustaste gedrückt hält. Die Markierung wird entfernt, wenn der Benutzer die Maustaste loslässt.
BST_UNCHECKED Gibt an, dass die Schaltfläche deaktiviert ist. Dasselbe wie ein Rückgabewert von 0 (null).

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.

Siehe auch

Übersicht über die Schaltflächen Schaltfläche Nachrichten, BM_GETCHECK, BM_SETSTATE