RichTextBox.SelectionFont-Eigenschaft

Ruft die Schriftart der aktuellen Textauswahl oder Einfügemarke ab oder legt diese fest.

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

Syntax

'Declaration
Public Property SelectionFont As Font
'Usage
Dim instance As RichTextBox
Dim value As Font

value = instance.SelectionFont

instance.SelectionFont = value

public Font SelectionFont { get; set; }

public:
property Font^ SelectionFont {
    Font^ get ();
    void set (Font^ value);
}

/** @property */
public Font get_SelectionFont ()

/** @property */
public void set_SelectionFont (Font value)

public function get SelectionFont () : Font

public function set SelectionFont (value : Font)

Eigenschaftenwert

Ein Font, der die Schriftart darstellt, die auf die aktuelle Textauswahl oder auf den nach der Einfügemarke eingegebenen Text angewendet werden soll.

Hinweise

Wenn für die aktuelle Textauswahl mehr als eine Schriftart angegeben ist, ist diese Eigenschaft NULL (Nothing in Visual Basic). Wenn derzeit kein Text markiert ist, wird die in dieser Eigenschaft angegebene Schriftart auf die aktuelle Einfügemarke und auf nach der Einfügemarke in das Steuerelement eingegebenen Text angewendet. Die Einstellung für die Schriftart wird angewendet, bis die Eigenschaft auf eine andere Schriftart geändert oder die Einfügemarke in einen anderen Abschnitt des Steuerelements verschoben wird.

Wenn Text im Steuerelement markiert ist, wird auf diesen und sämtlichen danach eingegebenen Text der Wert dieser Eigenschaft angewendet. Mit dieser Eigenschaft können Sie den Schriftschnitt des Texts in RichTextBox ändern. Sie können den Text des Steuerelements fett, kursiv und unterstrichen formatieren. Außerdem können Sie die Größe des Texts und die auf den Text angewendete Schriftart ändern.

Um die Farbe des Texts im Steuerelement zu ändern, verwenden Sie die SelectionColor-Eigenschaft.

Beispiel

Im folgenden Codebeispiel wird die aktuelle Einstellung für die fett formatierte Schriftart der Textauswahl oder für den nach der Einfügemarke in das RichTextBox-Steuerelement eingegebenen Text geändert. Für dieses Beispiel ist es erforderlich, dass der Code in einer Methode in einem Form enthalten ist. Für das Beispiel ist es außerdem erforderlich, dass dem Form eine RichTextBox mit dem Namen richTextBox1 hinzugefügt wurde.

Private Sub ToggleBold()
   If Not richTextBox1.SelectionFont Is Nothing Then
      Dim currentFont As System.Drawing.Font = richTextBox1.SelectionFont
      Dim newFontStyle As System.Drawing.FontStyle

      If richTextBox1.SelectionFont.Bold = True Then
         newFontStyle = FontStyle.Regular
      Else
         newFontStyle = FontStyle.Bold
      End If

      richTextBox1.SelectionFont = New Font( _
         currentFont.FontFamily, _
         currentFont.Size, _
         newFontStyle _
      )
   End If
End sub

private void ToggleBold()
{
   if (richTextBox1.SelectionFont != null)
   {
      System.Drawing.Font currentFont = richTextBox1.SelectionFont;
      System.Drawing.FontStyle newFontStyle;

      if (richTextBox1.SelectionFont.Bold == true)
      {
         newFontStyle = FontStyle.Regular;
      }
      else
      {
         newFontStyle = FontStyle.Bold;
      }

      richTextBox1.SelectionFont = new Font(
         currentFont.FontFamily, 
         currentFont.Size, 
         newFontStyle
      );
   }
}

void ToggleBold()
{
   if ( richTextBox1->SelectionFont != nullptr )
   {
      System::Drawing::Font^ currentFont = richTextBox1->SelectionFont;
      System::Drawing::FontStyle newFontStyle;
      if ( richTextBox1->SelectionFont->Bold == true )
      {
         newFontStyle = FontStyle::Regular;
      }
      else
      {
         newFontStyle = FontStyle::Bold;
      }
      richTextBox1->SelectionFont = gcnew System::Drawing::Font( currentFont->FontFamily,currentFont->Size,newFontStyle );
   }
}

private void ToggleBold()
{
    if (richTextBox1.get_SelectionFont() != null) {
        System.Drawing.Font currentFont = richTextBox1.get_SelectionFont();
        System.Drawing.FontStyle newFontStyle;

        if (richTextBox1.get_SelectionFont().get_Bold() == true) {
            newFontStyle = FontStyle.Regular;
        }
        else {
            newFontStyle = FontStyle.Bold;
        }

        richTextBox1.set_SelectionFont(
            new Font(currentFont.get_FontFamily(), 
            currentFont.get_Size(), newFontStyle));
    }
} //ToggleBold

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
RichTextBox.SelectionColor-Eigenschaft
Select