CheckBox.CheckAlign Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ruft die horizontale und vertikale Ausrichtung des Häkchens in einem CheckBox-Steuerelement ab oder legt diese fest.

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 wechselnden Klicks des Steuerelements und den CheckAlign Alternativen zwischen den MiddleRight - und MiddleLeft -Werten von ContentAlignment. Dieses Beispiel zeigt, 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 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