Compartir a través de


Función CheckDlgButton (winuser.h)

Cambia el estado de comprobación de un control de botón.

Sintaxis

BOOL CheckDlgButton(
  [in] HWND hDlg,
  [in] int  nIDButton,
  [in] UINT uCheck
);

Parámetros

[in] hDlg

Tipo: HWND

Identificador del cuadro de diálogo que contiene el botón.

[in] nIDButton

Tipo: int

Identificador del botón que se va a modificar.

[in] uCheck

Tipo: UINT

Estado de comprobación del botón. Este parámetro puede ser uno de los valores siguientes.

Valor Significado
BST_CHECKED
Establece el estado del botón en activado.
BST_INDETERMINATE
Establece el estado del botón en gris, lo que indica un estado indeterminado. Use este valor solo si el botón tiene el estilo BS_3STATE o BS_AUTO3STATE .
BST_UNCHECKED
Establece el estado del botón en desactivado.

Valor devuelto

Tipo: BOOL

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

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

Ejemplos

Para obtener un ejemplo, vea Crear un cuadro de diálogo Modeless en Usar cuadros de diálogo.

Requisitos

   
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado winuser.h (incluir Windows.h)
Library User32.lib
Archivo DLL User32.dll
Conjunto de API ext-ms-win-ntuser-dialogbox-l1-1-0 (introducido en Windows 8)

Consulte también

CheckRadioButton

IsDlgButtonChecked

Referencia