CheckDlgButton info  Overview  Group

The CheckDlgButton function changes the check state of a button control.

BOOL CheckDlgButton(

HWND hDlg,	// handle to dialog box
int nIDButton,	// button-control identifier
UINT uCheck	// check state
);

Parameters

hDlg

Identifies the dialog box that contains the button.

nIDButton

Identifies the button to modify.

uCheck

Specifies the check state of the button. 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 unchecked

Return Values

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero. To get extended error information, call GetLastError.

Remarks

The CheckDlgButton function sends a BM_SETCHECK message to the specified button control in the specified dialog box.

See Also

CheckRadioButton, IsDlgButtonChecked