CheckDlgButton
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