winuser.h


CheckDlgButton

La función CheckDlgButton cambia el estado de activación (check state) de un control button.

Sintaxis

BOOL CheckDlgButton(
    HWND hDlg,      // manipulador del cuadro de diálogo
    int nIDButton,  // identificador del contol button
    UINT uCheck     // estado de activación (check state)
   );

Parámetros:

hDlg: identifica el cuadro de diálogo que contiene el control botón.

nIDButton: identifica el botón a modificar.

uCheck: especifica el estado de activación del botón. Este parámetro puede tomar uno de los siguientes valores:

Valor Significado
BST_CHECKED Cambia el estado del botón a marcado.
BST_INDETERMINATE Cambia el estado del botón a gris, indica un estado indeterminado. Usar este valor sólo su el botón tiene el estilo BS_3STATE o BS_AUTO3STATE.
BST_UNCHECKED Cambia el estado del botón a no marcado.

Valor de retorno

Si la función tiene éxito, el valor de retorno es distinto de cero.

Si falla, el valor de retorno es cero. Para conseguir más información, se puede llamar a GetLastError.

Observaciones

La función CheckDlgButton envía un mensaje BM_SETCHECK al control botón especificado del cuadro de diálogo indicado.