CheckBox.ThreeState Eigenschaft

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft einen Wert ab, der angibt, ob für die CheckBox drei anstelle von zwei Aktivierungszuständen zulässig sind, oder legt diesen fest.

public:
 property bool ThreeState { bool get(); void set(bool value); };

public bool ThreeState { get; set; }

member this.ThreeState : bool with get, set

Public Property ThreeState As Boolean

Eigenschaftswert

Boolean

true, wenn die CheckBox drei Aktivierungszustände anzeigen kann, andernfalls false. Der Standardwert ist false.

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. Dieser Code erfordert, dass ein CheckBox Label - 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 auf den Indeterminate Wert von System.Windows.Forms.CheckState im Code und nicht durch Benutzerinteraktion festgelegt werden.

Gilt für: