CheckBox.Checked Propriété

Définition

Obtient ou définit une valeur indiquant si CheckBox est activé.Gets or set a value indicating whether the CheckBox is in the checked state.

public:
 property bool Checked { bool get(); void set(bool value); };
[System.ComponentModel.Bindable(true)]
[System.ComponentModel.SettingsBindable(true)]
public bool Checked { get; set; }
[System.ComponentModel.Bindable(true)]
public bool Checked { get; set; }
[<System.ComponentModel.Bindable(true)>]
[<System.ComponentModel.SettingsBindable(true)>]
member this.Checked : bool with get, set
[<System.ComponentModel.Bindable(true)>]
member this.Checked : bool with get, set
Public Property Checked As Boolean

Valeur de propriété

Boolean

true si CheckBox est cochée ; sinon, false.true if the CheckBox is in the checked state; otherwise, false. La valeur par défaut est false.The default value is false.


Si la ThreeState propriété a la valeur true , la Checked propriété retourne true pour Checked ou Indeterminate CheckState .If the ThreeState property is set to true, the Checked property will return true for either a Checked or IndeterminateCheckState.

Attributs

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 une ContentAlignment valeur de MiddleRight et MiddleLeft .The ThreeState property alternates between true and false with alternating clicks of the control and the CheckAlign alternates between a ContentAlignment value of MiddleRight and MiddleLeft. 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. Cet exemple requiert qu’un CheckBox , Label et Button ont 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 example 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

Lorsque la valeur est true , la CheckBox partie du contrôle affiche une coche.When the value is true, the CheckBox portion of the control displays a check mark. Si la Appearance propriété a la valeur Button , le contrôle apparaît enfoncé lorsque Checked est et est true déclenché comme un bouton standard quand false .If the Appearance property is set to Button, the control will appear sunken when Checked is true and raised like a standard button when false.

S’applique à

Voir aussi