IsDlgButtonChecked
The IsDlgButtonChecked
function determines whether a button control has a check mark next to it or
whether a three-state button control is grayed, checked, or neither.
UINT IsDlgButtonChecked(
|
HWND hDlg, |
// handle of dialog
box |
|
int nIDButton |
// button
identifier |
|
); |
|
Parameters
hDlg
Identifies
the dialog box that contains the button control.
nIDButton
Specifies the
integer identifier of the button control.
Return Values
The return
value from a button created with the BS_AUTOCHECKBOX, BS_AUTORADIOBUTTON,
BS_AUTO3STATE, BS_CHECKBOX, BS_RADIOBUTTON, or BS_3STATE style can be one of
the following:
|
Value |
Meaning |
|
BST_CHECKED |
Button is
checked. |
|
BST_INDETERMINATE |
Button is
grayed, indicating an indeterminate state (applies only if the button has the
BS_3STATE or BS_AUTO3STATE style). |
|
BST_UNCHECKED |
Button is
unchecked |
If the button
has any other style, the return value is zero.
Remarks
The IsDlgButtonChecked
function sends a BM_GETCHECK
message to the specified button control.
See Also