Funzione IsDlgButtonChecked (winuser.h)

  • Articolo

La funzione IsDlgButtonChecked determina se viene controllato un controllo pulsante o se viene controllato un controllo pulsante a tre stati, deselezionato o indeterminato.

Sintassi

UINT IsDlgButtonChecked(
  [in] HWND hDlg,
  [in] int  nIDButton
);

Parametri

[in] hDlg

Tipo: HWND

Handle alla finestra di dialogo contenente il controllo pulsante.

[in] nIDButton

Tipo: int

Identificatore del controllo pulsante.

Valore restituito

Tipo: UINT

Il valore restituito da un pulsante creato con gli stiliBS_AUTOCHECKBOX, BS_AUTORADIOBUTTON, BS_AUTO3STATE, BS_CHECKBOX, BS_RADIOBUTTON o BS_3STATE può essere uno dei valori della tabella seguente. Se il pulsante ha qualsiasi altro stile, il valore restituito è zero.

Codice restituito Descrizione
BST_CHECKED
 Il pulsante viene selezionato.
BST_INDETERMINATE
 Il pulsante si trova in uno stato indeterminato (si applica solo se il pulsante ha lo stile BS_3STATE o BS_AUTO3STATE ).
BST_UNCHECKED
 Il pulsante non è selezionato.

Commenti

La funzione IsDlgButtonChecked invia un messaggio BM_GETCHECK al controllo pulsante specificato.

Esempio

Per un esempio, vedere la sezione intitolata "Creazione di una finestra di dialogo senza modalità" in Uso delle 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

CheckDlgButton