CheckBox.CheckAlign Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Quelle:

CheckBox.cs

Dient zum Abrufen oder Festlegen der horizontalen und vertikalen Ausrichtung des Häkchens für ein CheckBox Steuerelement.

public:
 property System::Drawing::ContentAlignment CheckAlign { System::Drawing::ContentAlignment get(); void set(System::Drawing::ContentAlignment value); };

[System.ComponentModel.Bindable(true)]
public System.Drawing.ContentAlignment CheckAlign { get; set; }

[<System.ComponentModel.Bindable(true)>]
member this.CheckAlign : System.Drawing.ContentAlignment with get, set

Public Property CheckAlign As ContentAlignment

Eigenschaftswert

ContentAlignment

Einer der ContentAlignment Werte. Der Standardwert ist MiddleLeft.

Attribute

BindableAttribute

Ausnahmen

InvalidEnumArgumentException

Der zugewiesene Wert ist keiner der ContentAlignment 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 und den CheckAlign Wechsel zwischen den Werten und MiddleLeft werten MiddleRight des ContentAlignmentSteuerelements. 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 CheckBox, Label und Button alle auf einem Formular instanziiert wurden und dass die Beschriftung groß genug ist, um drei Textzeilen sowie einen Verweis auf den System.Drawing Namespace anzuzeigen. 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

Weitere Informationen

• TextAlign
• ContentAlignment