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.