CheckBox.ThreeState Propriété

Définition

Obtient ou définit une valeur indiquant si CheckBox autorise l'affichage de trois états d'activation au lieu de deux.Gets or sets a value indicating whether the CheckBox will allow three check states rather than two.

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 CheckBox peut afficher trois états d'activation ; sinon, false.true if the CheckBox is able to display three check states; otherwise, false. La valeur par défaut est false.The default value is false.

Exemples

L’exemple de code suivant affiche les valeurs de trois propriétés dans une étiquette.The following code example displays the values of three properties in a label. La ThreeState propriété alterne entre true et false avec des clics alternatifs du contrôle et les CheckAlign alternatives entre les MiddleRight MiddleLeft valeurs et de System.Drawing.ContentAlignment .The ThreeState property alternates between true and false with alternating clicks of the control and the CheckAlign alternates between the MiddleRight and MiddleLeft values of System.Drawing.ContentAlignment. Cet exemple montre comment les valeurs de propriété changent lorsque la ThreeState propriété change et que le contrôle est activé.This example shows how the property values change as the ThreeState property changes and the control is checked. Ce code requiert qu’un CheckBox , Label et Button aient tous é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' System.Drawing espace de noms.This code requires that a CheckBox, Label and Button have all been instantiated on a form and that the label is large enough to display three lines of text, as well as a reference to the System.Drawing namespace. Ce code doit être appelé dans le Click Gestionnaire d’événements du contrôle.This code should be called in the Click event handler of the control.

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 sur false , la valeur CheckState de la propriété peut uniquement être définie sur la Indeterminate valeur de System.Windows.Forms.CheckState dans le code et non sur l’interaction de l’utilisateur.If the ThreeState property is set to false, the CheckState property value can only be set to the Indeterminate value of System.Windows.Forms.CheckState in code and not by user interaction.

S’applique à