CheckBox.Checked Propiedad

Definición

Obtiene o establece un valor que indica si CheckBox está en el estado activado.

C#
[System.ComponentModel.Bindable(true)]
public bool Checked { get; set; }
C#
[System.ComponentModel.Bindable(true)]
[System.ComponentModel.SettingsBindable(true)]
public bool Checked { get; set; }

Valor de propiedad

true si el control CheckBox se encuentra en estado seleccionado; en caso contrario, es false. El valor predeterminado es false.

Nota: Si la ThreeState propiedad está establecida trueen , la Checked propiedad devolverá true para o IndeterminateCheckedCheckState.

Atributos

Ejemplos

En el ejemplo de código siguiente se muestran los valores de tres propiedades de una etiqueta. La ThreeState propiedad alterna entre true y false con clics alternativos del control y las CheckAlign alternativas entre un ContentAlignment valor de MiddleRight y MiddleLeft. En este ejemplo se muestra cómo cambian los valores de propiedad a medida que cambia la ThreeState propiedad y se comprueba el control. En este ejemplo se requiere que CheckBoxLabel se haya creado una instancia de y Button en un formulario y que la etiqueta sea lo suficientemente grande como para mostrar tres líneas de texto, así como una referencia al System.Drawing espacio de nombres. Se debe llamar a este código en el Click controlador de eventos del control .

C#
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(); 
 }

Comentarios

Cuando el valor es true, la CheckBox parte del control muestra una marca de verificación. Si la Appearance propiedad se establece Buttonen , el control aparecerá hundido cuando Checked sea true y se genere como un botón estándar cuando false.

Se aplica a

Producto Versiones
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9, 10

Consulte también