Funzione IsDlgButtonChecked (winuser.h)

Articolo
08/27/2023

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 stili BS_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

Condividi tramite