Compartir a través de

Función IsDlgButtonChecked (winuser.h)

  • Artículo

La función IsDlgButtonChecked determina si se comprueba un control de botón o si un control de botón de tres estados está activado, desmarcado o indeterminado.

Sintaxis

UINT IsDlgButtonChecked(
  [in] HWND hDlg,
  [in] int  nIDButton
);

Parámetros

[in] hDlg

Tipo: HWND

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

[in] nIDButton

Tipo: int

Identificador del botón.

Valor devuelto

Tipo: UINT

El valor devuelto de un botón creado con los estilos BS_AUTOCHECKBOX, BS_AUTORADIOBUTTON, BS_AUTO3STATE, BS_CHECKBOX, BS_RADIOBUTTON o BS_3STATE puede ser uno de los valores de la tabla siguiente. Si el botón tiene cualquier otro estilo, el valor devuelto es cero.

Código devuelto Descripción
BST_CHECKED
 El botón está activado.
BST_INDETERMINATE
 El botón está en un estado indeterminado (solo se aplica si el botón tiene el estilo BS_3STATE o BS_AUTO3STATE ).
BST_UNCHECKED
 El botón no está activado.

Comentarios

La función IsDlgButtonChecked envía un mensaje BM_GETCHECK al control de botón especificado.

Ejemplos

Para obtener un ejemplo, vea la sección titulada "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 (incluya 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

CheckDlgButton