BM_GETSTATE message
Retrieves the state of a button or check box. You can send this message explicitly or use the Button_GetState macro.
Parameters
- wParam
-
Not used; must be zero.
- lParam
-
Not used; must be zero.
Return value
The return value specifies the current state of the button. It is a combination of the following values.
| Return code | Description |
|---|---|
|
The button is checked. |
|
Windows Vista. The button is in the drop-down state. Applies only if the button has the TBSTYLE_DROPDOWN style. |
|
The button has the keyboard focus. |
|
The button is hot; that is, the mouse is hovering over it. |
|
The state of the button is indeterminate. Applies only if the button has the BS_3STATE or BS_AUTO3STATE style. |
|
The button is being shown in the pushed state. |
|
No special state. Equivalent to zero. |
Requirements
|
Minimum supported client | Windows 2000 Professional [desktop apps only] |
|---|---|
|
Minimum supported server | Windows 2000 Server [desktop apps only] |
|
Header |
|
See also
- Reference
- BM_GETCHECK
- BM_SETSTATE
Send comments about this topic to Microsoft
Build date: 10/27/2012