CheckBox.Checked CheckBox.Checked CheckBox.Checked CheckBox.Checked Property

Definición

Obtiene o establece un valor que indica si CheckBox está en el estado activado.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; }
member this.Checked : bool with get, set
Public Property Checked As Boolean

Valor de propiedad

true si el control CheckBox se encuentra en estado seleccionado; en caso contrario, es false.true if the CheckBox is in the checked state; otherwise, false. El valor predeterminado es false.The default value is false.

Si el ThreeState propiedad está establecida en true, el Checked propiedad devolverá true cualquiera un Checked o Indeterminate CheckState.If the ThreeState property is set to true, the Checked property will return true for either a Checked or IndeterminateCheckState.

Ejemplos

El ejemplo de código siguiente muestra los valores de las tres propiedades en una etiqueta.The following code example displays the values of three properties in a label. El ThreeState propiedad alterna entre true y false según el clic del control y el CheckAlign alterna entre un ContentAlignment valor MiddleRight y 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. En este ejemplo se muestra cómo cambian los valores de propiedad como el ThreeState se comprueban los cambios de propiedad y el control.This example shows how the property values change as the ThreeState property changes and the control is checked. Este ejemplo requiere que un CheckBox, Label y Button todos se creen instancias de un formulario y que la etiqueta es lo suficientemente grande como para mostrar tres líneas de texto, así como una referencia a la System.Drawing espacio de nombres.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. Este código debe llamarse en el Click controlador de eventos del control.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

Comentarios

Cuando el valor es true, CheckBox parte del control muestra una marca de verificación.When the value is true, the CheckBox portion of the control displays a check mark. Si el Appearance propiedad está establecida en Button, el control mostrará bajo relieve cuando Checked es true y se genera como un estándar de botón cuando 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.

Se aplica a

Consulte también: