CheckBox.ThreeState Propriété

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Source:

CheckBox.cs

Obtient ou définit une valeur indiquant si les CheckBox trois états de vérification sont autorisés plutôt que deux.

public:
 property bool ThreeState { bool get(); void set(bool value); };

public bool ThreeState { get; set; }

member this.ThreeState : bool with get, set

Public Property ThreeState As Boolean

Valeur de propriété

Boolean

true si l’option CheckBox est en mesure d’afficher trois états de vérification ; sinon, false. La valeur par défaut est false.

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é. Ce code exige qu’un CheckBox, Label et Button tous ont été instanciés sur un formulaire et que l’étiquette soit 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 ThreeState propriété est définie falsesur , la valeur de la CheckState propriété ne peut être définie que sur la Indeterminate valeur du System.Windows.Forms.CheckState code et non par interaction utilisateur.