Compartilhar via

CheckBox.CheckState Propriedade

  • Referência

Definição

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Obtém ou define o estado do 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 da propriedade

CheckState

Um dos valores de enumeração CheckState. O valor padrão é Unchecked.

Atributos
BindableAttribute

Exceções

InvalidEnumArgumentException

O valor atribuído não é um dos valores de enumeração CheckState.

Exemplos

O exemplo de código a seguir exibe os valores de três propriedades em um rótulo. A ThreeState propriedade alterna entre true e false com cliques alternados do controle e as CheckAlign alternativas entre os MiddleRight valores e MiddleLeft de System.Drawing.ContentAlignment. Este exemplo mostra como os valores da propriedade mudam conforme a ThreeState propriedade é alterada e o controle é verificado. Este exemplo exige que um CheckBoxe LabelButton tenham sido instanciados em um formulário e que o rótulo seja grande o suficiente para exibir três linhas de texto, bem como uma referência ao System.Drawing namespace. Esse código deve ser chamado no Click manipulador de eventos do controle.

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

Comentários

Se a ThreeState propriedade for definida como false, o valor da CheckState propriedade só poderá ser definido CheckState.Indeterminate como no código e não pela interação do usuário.

A tabela a seguir descreve o System.Windows.Forms.Appearance do controle em seus diferentes estados para o Normal controle CheckBox.Appearancede estilo e Button .CheckBox

CheckState Aparência.Normal Appearance.Button
Checked O CheckBox exibe uma marca de marcar. O controle aparece afundado.
Unchecked O CheckBox está vazio. O controle aparece gerado.
Indeterminate O CheckBox exibe uma marca marcar e é sombreado. O controle aparece plano.

Aplica-se a

Confira também