winuser.h
IsDlgButtonChecked
La función IsDlgButtonChecked determina si un botón tiene una marca o si un botón de tres estados está gris, marcado o no marcado.
Sintaxis
UINT IsDlgButtonChecked(
HWND hDlg, // manipulador de cuadro de diálogo
int nIDButton // identificador de botón
);
Parámetros:
hDlg: identifica el cuadro de diálogo que contiene el control botón.
nIDButton: especifica el identificador entero de un control botón.
Valor de retorno
El valor de retorno para un botón creado con el estilo BS_AUTOCHECKBOX, BS_AUTORADIOBUTTON, BS_AUTO3STATE, BS_CHECKBOX, BS_RADIOBUTTON o BS_3STATE puede ser uno de los siguientes:
| Valor | Significado |
|---|---|
| BST_CHECKED | El botón está marcado. |
| BST_INDETERMINATE | El botón está estado gris (grayed), indica un estado indeterminado. Usar este valor sólo si el botón tiene el estilo BS_3STATE o BS_AUTO3STATE. |
| BST_UNCHECKED | El botón está no marcado. |
Si el botón tiene cualquier otro estilo, el valor de retorno es cero.
Observaciones
La función IsDlgButtonChecked evía un mensaje BM_GETCHECK al botón especificado.