CheckBox.CheckState Właściwość

Odwołanie

Definicja

Przestrzeń nazw:: System.Windows.Forms

Zestaw:: System.Windows.Forms.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Pobiera lub ustawia stan obiektu 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

Wartość właściwości

CheckState

Jedna z CheckState wartości wyliczenia. Wartość domyślna to Unchecked.

Atrybuty: BindableAttribute

Wyjątki

InvalidEnumArgumentException

Przypisana wartość nie jest jedną z CheckState wartości wyliczenia.

Przykłady

Poniższy przykład kodu przedstawia wartości trzech właściwości w etykiecie. Właściwość ThreeState zmienia się między true elementami i false z przemiennymi kliknięciami kontrolki i CheckAlign alternatywnymi wartościami MiddleLeftMiddleRightSystem.Drawing.ContentAlignmenti . W tym przykładzie pokazano, jak wartości właściwości zmieniają się w miarę ThreeState zmiany właściwości, a kontrolka jest sprawdzana. W tym przykładzie jest wymagane utworzenie CheckBoxwystąpienia elementu i Label Button zostało utworzone w formularzu i że etykieta jest wystarczająco duża, aby wyświetlić trzy wiersze tekstu, a także odwołanie do System.Drawing przestrzeni nazw. Ten kod powinien być wywoływany w procedurze Click obsługi zdarzeń kontrolki.

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

Uwagi

ThreeState Jeśli właściwość jest ustawiona na false, CheckState wartość właściwości można ustawić CheckState.Indeterminate tylko w kodzie, a nie przez interakcję użytkownika.

W poniższej tabeli opisano System.Windows.Forms.Appearance kontrolkę CheckBox w różnych stanach dla kontrolki NormalCheckBox.Appearancestylu i Button .

Checkstate	Wygląd.Normalny	Wygląd.Przycisk
`Checked`	Zostanie CheckBox wyświetlony znacznik wyboru.	Kontrolka jest widoczna zatopione.
`Unchecked`	Wartość jest pusta CheckBox .	Zostanie wyświetlona kontrolka.
`Indeterminate`	Wyświetla CheckBox znacznik wyboru i jest zacieniony.	Kontrolka jest wyświetlana płasko.

Dotyczy