CheckBox.CheckState Proprietà

Riferimento

Definizione

Spazio dei nomi:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Ottiene o imposta lo stato dell'oggetto CheckBox.

public:
 property System::Windows::Forms::CheckState CheckState { System::Windows::Forms::CheckState get(); void set(System::Windows::Forms::CheckState value); };

[System.ComponentModel.Bindable(true)]
public System.Windows.Forms.CheckState CheckState { get; set; }

[<System.ComponentModel.Bindable(true)>]
member this.CheckState : System.Windows.Forms.CheckState with get, set

Public Property CheckState As CheckState

Valore della proprietà

CheckState

Uno dei valori dell'enumerazione CheckState. Il valore predefinito è Unchecked.

Attributi: BindableAttribute

Eccezioni

InvalidEnumArgumentException

Il valore assegnato non è un valore di enumerazione CheckState.

Esempio

Nell'esempio di codice seguente vengono visualizzati i valori di tre proprietà in un'etichetta. La ThreeState proprietà si alterna tra true e false con clic alternati del controllo e le CheckAlign alternative tra i MiddleRight valori e MiddleLeft di System.Drawing.ContentAlignment. In questo esempio viene illustrato il modo in cui i valori delle proprietà cambiano man mano che la ThreeState proprietà cambia e il controllo viene controllato. Questo esempio richiede che sia stata creata un'istanza CheckBox Label di e Button in una maschera e che l'etichetta sia sufficientemente grande da visualizzare tre righe di testo, nonché un riferimento allo spazio dei System.Drawing nomi. Questo codice deve essere chiamato nel Click gestore eventi del controllo .

private:
   void AdjustMyCheckBoxProperties()
   {
      // Concatenate the property values together on three lines.
      label1->Text = String::Format( "ThreeState: {0}\nChecked: {1}\nCheckState: {2}",
         checkBox1->ThreeState, checkBox1->Checked, checkBox1->CheckState );
      
      // Change the ThreeState and CheckAlign properties on every other click.
      if ( !checkBox1->ThreeState )
      {
         checkBox1->ThreeState = true;
         checkBox1->CheckAlign = ContentAlignment::MiddleRight;
      }
      else
      {
         checkBox1->ThreeState = false;
         checkBox1->CheckAlign = ContentAlignment::MiddleLeft;
      }
   }

private void AdjustMyCheckBoxProperties()
 {
    // Change the ThreeState and CheckAlign properties on every other click.
    if (!checkBox1.ThreeState)
    {
       checkBox1.ThreeState = true;
       checkBox1.CheckAlign = ContentAlignment.MiddleRight;
    }
    else
    {
       checkBox1.ThreeState = false;
       checkBox1.CheckAlign = ContentAlignment.MiddleLeft;
    }

    // Concatenate the property values together on three lines.
    label1.Text = "ThreeState: " + checkBox1.ThreeState.ToString() + "\n" +
                  "Checked: " + checkBox1.Checked.ToString() + "\n" +
                  "CheckState: " + checkBox1.CheckState.ToString(); 
 }

Private Sub AdjustMyCheckBoxProperties()

    ' Change the ThreeState and CheckAlign properties on every other click.
    If Not checkBox1.ThreeState Then
        checkBox1.ThreeState = True
        checkBox1.CheckAlign = ContentAlignment.MiddleRight
    Else
        checkBox1.ThreeState = False
        checkBox1.CheckAlign = ContentAlignment.MiddleLeft
    End If

    ' Concatenate the property values together on three lines.
    label1.Text = "ThreeState: " & checkBox1.ThreeState.ToString() & ControlChars.Cr & _
        "Checked: " & checkBox1.Checked.ToString() & ControlChars.Cr & _
        "CheckState: " & checkBox1.CheckState.ToString()

End Sub

Commenti

Se la ThreeState proprietà è impostata su , il valore della CheckState proprietà può essere impostato CheckState.Indeterminatefalsesolo su nel codice e non dall'interazione dell'utente.

Nella tabella seguente viene descritto l'oggetto System.Windows.Forms.Appearance del CheckBox controllo nei relativi stati diversi per il Normal controllo di stile CheckBox.Appearancee Button .

Checkstate	Aspetto.Normale	Appearance.Button
`Checked`	Visualizza CheckBox un segno di spunta.	Il controllo viene visualizzato incassato.
`Unchecked`	La classe CheckBox è vuota.	Viene visualizzato il controllo .
`Indeterminate`	Visualizza CheckBox un segno di spunta ed è ombreggiato.	Il controllo viene visualizzato senza effetti.

Si applica a