Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This message is sent by an application to set the check state of a radio button or check box.

Syntax

BM_SETCHECK 
wParam = (WPARAM) 
fCheck, 

lParam = 0;

Parameters

fCheck

Specifies the check state. It is one of the following values.

Value Description

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 unchecked.

lParam

Not used.

Return Value

This message always returns zero.

Remarks

The BM_SETCHECK message has no effect on push buttons.

Requirements

Header winuser.h
Windows Embedded CE Windows CE 1.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also