Función CheckRadioButton (winuser.h)

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