RichTextBox.SelectionAlignment-Eigenschaft

Ruft die auf die aktuelle Auswahl oder Einfügemarke anzuwendende Ausrichtung ab oder legt diese fest.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Syntax

'Declaration
Public Property SelectionAlignment As HorizontalAlignment
'Usage
Dim instance As RichTextBox
Dim value As HorizontalAlignment

value = instance.SelectionAlignment

instance.SelectionAlignment = value

public HorizontalAlignment SelectionAlignment { get; set; }

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

/** @property */
public HorizontalAlignment get_SelectionAlignment ()

/** @property */
public void set_SelectionAlignment (HorizontalAlignment value)

public function get SelectionAlignment () : HorizontalAlignment

public function set SelectionAlignment (value : HorizontalAlignment)

Eigenschaftenwert

Einer der HorizontalAlignment-Werte.

Ausnahmen

Hinweise

Wenn im Steuerelement kein Absatz markiert ist, wird durch Festlegen dieser Eigenschaft die Ausrichtungseinstellung auf den Absatz angewendet, in dem die Einfügemarke angezeigt wird, sowie auf die Absätze, die nach dem Absatz mit der Eigenschaftseinstellung für die Ausrichtung erstellt werden. Angenommen, ein RichTextBox-Steuerelement enthält zwei Absätze und die Einfügemarke befindet sich im zweiten Absatz. Wenn Sie die SelectionAlignment-Eigenschaft auf HorizontalAlignment.Center festlegen, wird der Absatz an der Einfügemarke im Steuerelement zentriert. Wenn nach dem zweiten ein dritter Absatz erstellt wird, wird dieser ebenfalls an der Mitte des Steuerelements ausgerichtet.

Wenn im Steuerelement eine Auswahl vorgenommen wird, nachdem die Eigenschaft festgelegt ist, werden alle markierten Absätze dieser Eigenschaftseinstellung entsprechend angezeigt. Mit dieser Eigenschaft können Sie die Absätze in einem in RichTextBox erstellten Dokument ausrichten. Wenn z. B. alle Absätze in einem Dokument zentriert werden sollen, können Sie alle Absätze im Steuerelement markieren und die SelectionAlignment-Eigenschaft auf HorizontalAlignment.Center festlegen.

Beispiel

Im folgenden Codebeispiel wird veranschaulicht, wie Text in der RichTextBox ausgerichtet wird. Für dieses Beispiel ist es erforderlich, dass dem Formular ein RichTextBox-Steuerelement mit dem Namen richTextBox1 hinzugefügt wurde.

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

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:
   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.set_ForeColor(Color.get_Red());
    // Set the alignment of the text that follows.
    richTextBox1.set_SelectionAlignment(HorizontalAlignment.Center);
    // Set the font for the text.
    richTextBox1.set_SelectionFont(new Font("Lucinda Console", 12));
    // Set the text within the control.
    richTextBox1.set_SelectedText("This text is centered using the"
        + "SelectionAlignment property.\n");
} //WriteCenteredTextToRichTextBox

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

RichTextBox-Klasse
RichTextBox-Member
System.Windows.Forms-Namespace
HorizontalAlignment-Enumeration