RichTextBox.SelectionAlignment Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Quelle:

RichTextBox.cs

Ruft die Ausrichtung ab, die auf die aktuelle Markierung oder Einfügemarke angewendet werden soll, oder legt sie fest.

public:
 property System::Windows::Forms::HorizontalAlignment SelectionAlignment { System::Windows::Forms::HorizontalAlignment get(); void set(System::Windows::Forms::HorizontalAlignment value); };

[System.ComponentModel.Browsable(false)]
public System.Windows.Forms.HorizontalAlignment SelectionAlignment { get; set; }

[<System.ComponentModel.Browsable(false)>]
member this.SelectionAlignment : System.Windows.Forms.HorizontalAlignment with get, set

Public Property SelectionAlignment As HorizontalAlignment

Eigenschaftswert

HorizontalAlignment

Einer der HorizontalAlignment Werte.

Attribute

BrowsableAttribute

Ausnahmen

InvalidEnumArgumentException

Der angegebene Wert ist keine der in der HorizontalAlignment Klasse definierten Werte.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Text innerhalb der RichTextBox. Dieses Beispiel erfordert, dass dem Formular ein Steuerelement mit dem Namen hinzugefügt wurde.This example requires that a RichTextBox control, named richTextBox1, has been added to the form.

private:
   void WriteCenteredTextToRichTextBox()
   {
      // Clear all text from the RichTextBox;
      richTextBox1->Clear();

      // Set the foreground color of the text.
      richTextBox1->ForeColor = Color::Red;

      // Set the alignment of the text that follows.
      richTextBox1->SelectionAlignment = HorizontalAlignment::Center;

      // Set the font for the text.
      richTextBox1->SelectionFont = gcnew System::Drawing::Font( "Lucinda Console",12 );

      // Set the text within the control.
      richTextBox1->SelectedText = "This text is centered using the SelectionAlignment property.\n";
   }

private void WriteCenteredTextToRichTextBox()
{
   // Clear all text from the RichTextBox;
   richTextBox1.Clear();
   // Set the foreground color of the text.
   richTextBox1.ForeColor = Color.Red;
   // Set the alignment of the text that follows.
   richTextBox1.SelectionAlignment = HorizontalAlignment.Center;
   // Set the font for the text.
   richTextBox1.SelectionFont = new Font("Lucinda Console", 12);
   // Set the text within the control.
   richTextBox1.SelectedText = "This text is centered using the SelectionAlignment property.\n";
}

Private Sub WriteCenteredTextToRichTextBox()
   ' Clear all text from the RichTextBox;
   richTextBox1.Clear()
   ' Set the foreground color of the text.
   richTextBox1.SelectionColor = Color.Red
   ' Set the alignment of the text that follows.
   richTextBox1.SelectionAlignment = HorizontalAlignment.Center
   ' Set the font for the text.
   richTextBox1.SelectionFont = new Font("Lucinda Console", 12)
   ' Set the text within the control.
   richTextBox1.SelectedText = "This text is centered using the SelectionAlignment property."

End Sub

Hinweise

Wenn kein Absatz im Steuerelement ausgewählt ist, wendet das Festlegen dieser Eigenschaft die Ausrichtungseinstellung auf den Absatz an, in dem die Einfügemarke angezeigt wird, sowie auf Absätze, die nach dem Absatz erstellt wurden, der die Ausrichtungseigenschaftseinstellung aufweist. Wenn beispielsweise zwei Absätze in einem RichTextBox Steuerelement vorhanden sind und sich die Einfügemarke innerhalb des zweiten Absatzes befindet. Wenn Sie die SelectionAlignment Eigenschaft auf HorizontalAlignment.Centerfestlegen, wird der Absatz an der Einfügemarke innerhalb des Steuerelements zentriert. Wenn nach dem zweiten Absatz ein dritter Absatz erstellt wird, wird er auch an der Mitte des Steuerelements ausgerichtet.

Wenn beim Festlegen der Eigenschaft eine Auswahl innerhalb des Steuerelements vorgenommen wird, werden alle markierten Absätze basierend auf dieser Eigenschaftseinstellung ausgerichtet. Mit dieser Eigenschaft können Sie die Absätze in einem Dokument ausrichten, das in der RichTextBoxDatei erstellt wird. Wenn beispielsweise alle Absätze in einem Dokument zentriert werden sollen, können Sie alle Absätze im Steuerelement markieren und die SelectionAlignment Eigenschaft auf HorizontalAlignment.Centerfestlegen.

Hinweis

SelectionAlignment gibt zurück SelectionAlignment.Left , wenn die Textauswahl mehrere Absätze mit gemischter Ausrichtung enthält.

Weitere Informationen

• HorizontalAlignment