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