Condividi tramite


Funzione CheckDlgButton (winuser.h)

Modifica lo stato di controllo di un controllo pulsante.

Sintassi

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

Parametri

[in] hDlg

Tipo: HWND

Handle per la finestra di dialogo contenente il pulsante.

[in] nIDButton

Tipo: int

Identificatore del pulsante da modificare.

[in] uCheck

Tipo: UINT

Stato di controllo del pulsante. Questo parametro può avere uno dei valori seguenti.

Valore Significato
BST_CHECKED
Imposta lo stato del pulsante su selezionato.
BST_INDETERMINATE
Imposta lo stato del pulsante su grigio, che indica uno stato indeterminato. Utilizzare questo valore solo se il pulsante ha lo stile BS_3STATE o BS_AUTO3STATE .
BST_UNCHECKED
Imposta lo stato del pulsante su cancellata

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 CheckDlgButton invia un messaggio BM_SETCHECK al controllo pulsante specificato nella finestra di dialogo specificata.

Esempio

Per un esempio, vedere Creazione di una finestra di dialogo senza modalità in Uso di finestre di dialogo.

Requisiti

   
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-0 (introdotto in Windows 8)

Vedi anche

CheckRadioButton

IsDlgButtonChecked

Riferimento