RichTextBox.SelectionAlignment Eigenschaft

Definition

Ruft die auf die aktuelle Auswahl oder Einfügemarke anzuwendende Ausrichtung ab oder legt diese 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

Ausnahmen

Der angegebene Wert ist keiner der in der HorizontalAlignment-Klasse definierten Werte.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Text innerhalb der RichTextBox. In diesem Beispiel ist erforderlich, dass dem Formular ein RichTextBox Steuerelement mit dem Namen richTextBox1"" hinzugefügt wurde.

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 diese 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 ein dritter Absatz nach dem zweiten Absatz erstellt wird, wird er auch an der Mitte des Steuerelements ausgerichtet.

Wenn eine Auswahl innerhalb des Steuerelements erfolgt, wenn die Eigenschaft festgelegt wird, werden alle ausgewählten Absätze basierend auf dieser Eigenschaftseinstellung ausgerichtet. Sie können diese Eigenschaft verwenden, um die Absätze in einem Dokument auszurichten, 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 auswählen 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.

Gilt für

Siehe auch