Programming |  Windows Programming |  bm_getcheck

BM_GETCHECK

Gets the check state of a radio button or check box.

Syntax

To send this message, call the SendMessage function as follows.

    lResult = SendMessage(      // returns LRESULT in lResult     
        (HWND)hWndControl,      // handle to destination control
        (UINT)BM_GETCHECK,      // message ID     
        (WPARAM) wParam,        // = 0; not used, must be zero
        (LPARAM) lParam         // = 0; not used, must be zero 
    );   

Parameters

• wParam
  Not used; must be zero.
• lParam
  Not used; must be zero.

Return Value

The return value from a button created with the BS_AUTOCHECKBOX, BS_AUTORADIOBUTTON, BS_AUTO3STATE, BS_CHECKBOX, BS_RADIOBUTTON, or BS_3STATE style can be one of the following.

• BST_CHECKED
  Button is checked.
• BST_UNCHECKED
  Button is cleared
• BST_INDETERMINATE
  Button is grayed, indicating an indeterminate state (applies only if the button has the BS_3STATE or BS_AUTO3STATE style).

Remarks

If the button has a style other than those listed, the return value is zero.

Message Information

• Header Declared in Winuser.h, include Windows.h
• Minimum operating systems Windows 95, Windows NT 3.1