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 la ThreeState propiedad está establecida en true, la Checked propiedad devolverá true para Checked o Indeterminate. CheckStateIf the ThreeState property is set to true, the Checked property will return true for either a Checked or IndeterminateCheckState.

Ejemplos

En el ejemplo de código siguiente se muestran los valores de tres propiedades en una etiqueta.The following code example displays the values of three properties in a label. La ThreeState propiedad alterna entre true y false con clics alternos del control y CheckAlign alterna entre un ContentAlignment valor de 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 ThreeState propiedad a medida que cambia la propiedad y se comprueba el control.This example shows how the property values change as the ThreeState property changes and the control is checked. En este ejemplo se requiere CheckBoxque Label se Button haya creado una instancia de y de todas las instancias de un formulario, y que la etiqueta sea lo suficientemente grande como para mostrar tres líneas de texto System.Drawing , así como una referencia al 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. Se debe llamar a este código en Click el 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, la 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 la Appearance propiedad se establece en Button, el control aparecerá hundido cuando Checked sea true y se inicie como un botón estándar falsecuando.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: