Edit

Share via

Button_SetCheck macro (windowsx.h)

  • Article

Sets the check state of a radio button or check box. You can use this macro or send the BM_SETCHECK message explicitly.

Syntax

LRESULT Button_SetCheck(
   HWND hwndCtl,
   int  check
);

Parameters

hwndCtl

Type: HWND

A handle to the button control.

check

Type: int

The check state. This parameter can be one of the following values.

Value Meaning
BST_CHECKED
 Sets the button state to checked.
BST_INDETERMINATE
 Sets the button state to grayed, indicating an indeterminate state. Use this value only if the button has the BS_3STATE or BS_AUTO3STATE style.
BST_UNCHECKED
 Sets the button state to cleared.

Return value

Type: LRESULT

The return value is always zero.

Remarks

The macro has no effect on push buttons.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header windowsx.h