Esporta (0) Stampa
Espandi tutto

Classe CheckBox

Rappresenta un oggetto CheckBox di Windows.

Spazio dei nomi: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

[ComVisibleAttribute(true)] 
[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)] 
public class CheckBox : ButtonBase
/** @attribute ComVisibleAttribute(true) */ 
/** @attribute ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch) */ 
public class CheckBox extends ButtonBase
ComVisibleAttribute(true) 
ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch) 
public class CheckBox extends ButtonBase

Utilizzare un oggetto CheckBox per consentire all'utente una scelta, ad esempio vero/falso oppure sì/no. Il controllo CheckBox può visualizzare un'immagine, un testo o entrambi.

I controlli CheckBox e RadioButton hanno una funzione simile: consentono all'utente di scegliere da un elenco di opzioni. I controlli CheckBox consentono all'utente di scegliere una combinazione di opzioni. Al contrario, i controlli RadioButton consentono all'utente di scegliere tra opzioni reciprocamente esclusive.

La proprietà Appearance determina se CheckBox avrà l'aspetto di un oggetto CheckBox classico o di un pulsante.

La proprietà ThreeState determina se il controllo supporterà due o tre stati. Utilizzare la proprietà Checked per ottenere o impostare il valore di un controllo CheckBox a due stati e la proprietà CheckState per ottenere o impostare il valore di un controllo CheckBox a tre stati.

NotaNota

Se la proprietà ThreeState è impostata su true, la proprietà Checked restituirà true nel caso di uno stato selezionato o indeterminato.

La proprietà FlatStyle determina lo stile e l'aspetto del controllo. Se la proprietà FlatStyle è impostata sul campo FlatStyle.System, il sistema operativo dell'utente determina l'aspetto del controllo.

NotaNota

Quando la proprietà FlatStyle è impostata sul campo FlatStyle.System, la proprietà CheckAlign viene ignorata e il controllo viene visualizzato utilizzando l'allineamento ContentAlignment.MiddleLeft o ContentAlignment.MiddleRight. Se la proprietà CheckAlign è impostata su uno degli allineamenti a destra, il controllo viene visualizzato utilizzando l'allineamento ContentAlignment.MiddleRight; in caso contrario, viene visualizzato utilizzando l'allineamento ContentAlignment.MiddleLeft.

Di seguito viene descritto uno stato indeterminato: un oggetto CheckBox stabilisce se il testo selezionato nell'oggetto RichTextBox è in grassetto. Quando si seleziona il testo, è possibile fare clic sull'oggetto CheckBox per applicare il grassetto alla selezione. Analogamente, quando si seleziona un testo, l'oggetto CheckBox indica se il testo selezionato è in grassetto. Se il testo selezionato contiene parole in grassetto e in formato normale, l'oggetto CheckBox presenta uno stato indeterminato.

Nell'esempio di codice riportato di seguito viene creato e inizializzato un oggetto CheckBox, al quale viene assegnato l'aspetto di un interruttore, quindi la proprietà AutoCheck viene impostata su false e aggiunta a un oggetto Form.

public void InstantiateMyCheckBox()
 {
    // Create and initialize a CheckBox.   
    CheckBox checkBox1 = new CheckBox(); 
    
    // Make the check box control appear as a toggle button.
    checkBox1.Appearance = Appearance.Button;
 
    // Turn off the update of the display on the click of the control.
    checkBox1.AutoCheck = false;
 
    // Add the check box control to the form.
    Controls.Add(checkBox1);
 }
 

public void InstantiateMyCheckBox()
{
    // Create and initialize a CheckBox.   
    CheckBox checkBox1 = new CheckBox();

    // Make the check box control appear as a toggle button.
    checkBox1.set_Appearance(Appearance.Button);

    // Turn off the update of the display on the click of the control.
    checkBox1.set_AutoCheck(false);

    // Add the check box control to the form.
    get_Controls().Add(checkBox1);
} //InstantiateMyCheckBox

public function InstantiateMyCheckBox()
 {
    // Create and initialize a CheckBox.   
    var checkBox1 : CheckBox = new CheckBox(); 
    
    // Make the check box control appear as a toggle button.
    checkBox1.Appearance = Appearance.Button;
 
    // Turn off the update of the display on the click of the control.
    checkBox1.AutoCheck = false;
 
    // Add the check box control to the form.
    Controls.Add(checkBox1);
 }
 

I membri statici pubblici (Shared in Visual Basic) di questo tipo sono validi per le operazioni multithreading. I membri di istanza non sono garantiti come thread safe.

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile per Pocket PC, Windows Mobile per Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema.

.NET Framework

Supportato in: 2.0 1.1 1.0

.NET Compact Framework

Supportato in: 2.0 1.0

Aggiunte alla community

AGGIUNGI
Mostra:
© 2014 Microsoft