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
);

[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

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.

La funzione CheckDlgButton invia un messaggio BM_SETCHECK al controllo pulsante specificato nella finestra di dialogo specificata.

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


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)

Riferimento