Partager via


CheckBox.CheckState Propriété

Définition

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

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

Attributs

Exceptions

La valeur assignée ne fait pas partie des valeurs de l'é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 MiddleRight valeurs et MiddleLeft 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 CheckBoxet ButtonLabel 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’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é a la ThreeStatefalsevaleur , la valeur de la CheckState propriété ne peut être définie que CheckState.Indeterminate sur dans le code et non par l’interaction de l’utilisateur.

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

CheckState Apparence.Normal Appearance.Button
Checked affiche CheckBox une marque case activée. Le contrôle apparaît enfoncé.
Unchecked La CheckBox est vide. Le contrôle apparaît déclenché.
Indeterminate Affiche CheckBox une marque case activée et est ombré. Le contrôle s'affiche sous une forme à deux dimensions.

S’applique à

Voir aussi