CheckBox.CheckState Propiedad

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Obtiene o establece el estado de la 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

Valor de propiedad

CheckState

Uno de los valores de enumeración de CheckState. El valor predeterminado es Unchecked.

Atributos

BindableAttribute

Excepciones

InvalidEnumArgumentException

El valor asignado no es uno de los valores de enumeración CheckState.

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 los MiddleRight valores y MiddleLeft de System.Drawing.ContentAlignment. 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 .

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

Si la ThreeState propiedad se establece falseen , el valor de la CheckState propiedad solo se puede establecer CheckState.Indeterminate en en el código y no en la interacción del usuario.

En la CheckBox tabla siguiente se describe el System.Windows.Forms.Appearance elemento del control en sus distintos estados para el Normal control CheckBox.Appearancede estilo y Button .

CheckState	Appearance.Normal	Appearance.Button
Checked	Muestra CheckBox una marca de verificación.	El control aparece hundido.
Unchecked	La colección CheckBox está vacía.	Aparece el control generado.
Indeterminate	CheckBox muestra una marca de verificación y está sombreada.	El control aparece sin relieve.

Consulte también

• Checked
• ThreeState