Freigeben über

CheckBox.CheckState Eigenschaft

  • Referenz

Definition

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

Ruft den CheckBox-Zustand ab oder legt ihn fest.

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

Eigenschaftswert

CheckState

Einer der CheckState-Enumerationswerte. Der Standardwert ist Unchecked.

Attribute
BindableAttribute

Ausnahmen

InvalidEnumArgumentException

Der zugewiesene Wert ist keiner der CheckState-Enumerationswerte.

Beispiele

Im folgenden Codebeispiel werden die Werte von drei Eigenschaften in einer Bezeichnung angezeigt. Die ThreeState -Eigenschaft wechselt zwischen true und false mit abwechselnden Klicks des -Steuerelements MiddleRightMiddleLeft und den CheckAlign -Werten von System.Drawing.ContentAlignmentund . In diesem Beispiel wird gezeigt, wie sich die Eigenschaftswerte ändern, wenn sich die ThreeState Eigenschaft ändert und das Steuerelement überprüft wird. Dieses Beispiel erfordert, dass ein CheckBoxLabel - und Button alle in einem Formular instanziiert wurden und dass die Bezeichnung groß genug ist, um drei Textzeilen anzuzeigen, sowie einen Verweis auf den System.Drawing Namespace. Dieser Code sollte im Click Ereignishandler des -Steuerelements aufgerufen werden.

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

Hinweise

Wenn die ThreeState Eigenschaft auf falsefestgelegt ist, kann der CheckState Eigenschaftswert nur im Code und nicht durch Benutzerinteraktionen auf CheckState.Indeterminate festgelegt werden.

In der folgenden Tabelle wird der System.Windows.Forms.Appearance des CheckBox Steuerelements in seinen unterschiedlichen Zuständen für das Steuerelement und Button das Normal Stilsteuerelement beschriebenCheckBox.Appearance.

CheckState Appearance.Normal Appearance.Button
Checked Zeigt CheckBox ein Häkchen an. Das Steuerelement wird versenkt angezeigt.
Unchecked Die CheckBox ist leer. Das Steuerelement wird ausgelöst.
Indeterminate Zeigt CheckBox ein Häkchen an und ist schattiert. Das Steuerelement wird flach dargestellt.

Gilt für:

Weitere Informationen