Funzione CheckRadioButton (winuser.h)

Aggiunge un segno di spunta a (controlli) un pulsante di opzione specificato in un gruppo e rimuove un segno di spunta da (cancella) tutti gli altri pulsanti di opzione nel gruppo.

Sintassi

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

Parametri

[in] hDlg

Tipo: HWND

Handle nella finestra di dialogo contenente il pulsante di opzione.

[in] nIDFirstButton

Tipo: int

Identificatore del primo pulsante di opzione nel gruppo.

[in] nIDLastButton

Tipo: int

Identificatore dell'ultimo pulsante di opzione nel gruppo.

[in] nIDCheckButton

Tipo: int

Identificatore del pulsante di opzione da selezionare.

Valore restituito

Tipo: BOOL

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

La funzione CheckRadioButton invia un messaggio BM_SETCHECK a ognuno dei pulsanti di opzione nel gruppo indicato.

I parametri nIDFirstButton e nIDLastButton specificano un intervallo di identificatori di pulsante (normalmente gli ID risorsa dei pulsanti). La posizione dei pulsanti nell'ordine di tabulazioni è irrilevante; se un pulsante fa parte di un gruppo, ma ha un ID all'esterno dell'intervallo specificato, non è interessato da questa chiamata.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione winuser.h (include Windows.h)
Libreria User32.lib
DLL User32.dll
Set di API ext-ms-win-ntuser-dialogbox-l1-1-2 (introdotta in Windows 10, versione 10.0.10240)

Vedi anche

CheckDlgButton

IsDlgButtonChecked

Riferimento