Compartir a través de

Función CheckRadioButton (winuser.h)

  • Artículo

Agrega una marca de verificación a (comprobaciones) un botón de radio especificado en un grupo y quita una marca de verificación de (borra) todos los demás botones de radio del grupo.

Sintaxis

BOOL CheckRadioButton(
  [in] HWND hDlg,
  [in] int  nIDFirstButton,
  [in] int  nIDLastButton,
  [in] int  nIDCheckButton
);

Parámetros

[in] hDlg

Tipo: HWND

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

[in] nIDFirstButton

Tipo: int

Identificador del primer botón de radio del grupo.

[in] nIDLastButton

Tipo: int

Identificador del último botón de radio del grupo.

[in] nIDCheckButton

Tipo: int

Identificador del botón de radio que se va a seleccionar.

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 CheckRadioButton envía un mensaje BM_SETCHECK a cada uno de los botones de radio del grupo indicado.

Los parámetros nIDFirstButton y nIDLastButton especifican un intervalo de identificadores de botón (normalmente los identificadores de recursos de los botones). La posición de los botones en el orden de tabulación es irrelevante; si un botón forma parte de un grupo, pero tiene un identificador fuera del intervalo especificado, no se ve afectado por esta llamada.

Requisitos

Requisito Value
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-2 (introducido en Windows 10, versión 10.0.10240)

Consulte también

CheckDlgButton

IsDlgButtonChecked

Referencia