CheckBox.CheckState Propriété

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Source:

CheckBox.cs

Obtient ou définit l’état du 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

Valeur de propriété

CheckState

Une des valeurs d’énumération CheckState . La valeur par défaut est Unchecked.

Attributs

BindableAttribute

Exceptions

InvalidEnumArgumentException

La valeur affectée n’est pas l’une des valeurs d’énumération CheckState .

Exemples

L’exemple de code suivant affiche les valeurs de trois propriétés dans une étiquette. La ThreeState propriété alterne entre true et false avec des clics alternés du contrôle et les CheckAlign alternatives entre les valeurs et MiddleLeft les MiddleRight valeurs de System.Drawing.ContentAlignment. Cet exemple montre comment les valeurs de propriété changent à mesure que la ThreeState propriété change et que le contrôle est vérifié. Cet exemple nécessite qu’un CheckBox, Label et Button tous ont été instanciés sur un formulaire et que l’étiquette est suffisamment grande pour afficher trois lignes de texte, ainsi qu’une référence à l’espace System.Drawing de noms. Ce code doit être appelé dans le Click gestionnaire d’événements du contrôle.

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

Remarques

Si la propriété est définie falsesur , la valeur de la CheckState propriété peut uniquement être définie CheckState.Indeterminate dans le ThreeState code et non par interaction utilisateur.

Le tableau suivant décrit le System.Windows.Forms.AppearanceCheckBox contrôle dans ses différents états pour le contrôle de style et Button le Normal contrôle CheckBox.Appearancede style.

CheckState	Apparence.Normal	Apparence.Button
Checked	Affiche CheckBox une coche.	Le contrôle apparaît enfoncé.
Unchecked	La CheckBox valeur est vide.	Le contrôle apparaît déclenché.
Indeterminate	Affiche CheckBox une coche et est ombrée.	Le contrôle apparaît plat.

Voir aussi

• Checked
• ThreeState