RichTextBox-Klasse

Stellt ein Windows-Textfeld-Steuerelement für RTF dar.

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

Syntax

'Declaration
<ComVisibleAttribute(True)> _
<ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)> _
Public Class RichTextBox
    Inherits TextBoxBase
'Usage
Dim instance As RichTextBox

[ComVisibleAttribute(true)] 
[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)] 
public class RichTextBox : TextBoxBase

[ComVisibleAttribute(true)] 
[ClassInterfaceAttribute(ClassInterfaceType::AutoDispatch)] 
public ref class RichTextBox : public TextBoxBase

/** @attribute ComVisibleAttribute(true) */ 
/** @attribute ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch) */ 
public class RichTextBox extends TextBoxBase

ComVisibleAttribute(true) 
ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch) 
public class RichTextBox extends TextBoxBase

Hinweise

Mit dem RichTextBox-Steuerelement kann der Benutzer Text eingeben und bearbeiten. Das Steuerelement stellt zudem umfangreichere Formatierungsfeatures als das TextBox-Standardsteuerelement bereit. Text kann dem Steuerelement direkt zugewiesen oder aus einer RTF-Datei (Rich Text Format) oder einer einfachen Textdatei geladen werden. Dem Text im Steuerelement können Zeichen- und Absatzformatierungen zugewiesen werden.

Das RichTextBox-Steuerelement stellt eine Anzahl von Eigenschaften bereit, mit denen Sie einem beliebigen Textteil im Steuerelement eine Formatierung zuweisen können. Zum Ändern der Textformatierung muss der Text zunächst markiert werden. Nur markiertem Text kann eine Zeichen- und Absatzformatierung zugewiesen werden. Wenn für einen markierten Textabschnitt eine Einstellung festgelegt wurde, wird der gesamte nach der Auswahl eingegebene Text mit denselben Einstellungen formatiert, bis diese geändert werden oder ein anderer Abschnitt des Dokuments des Steuerelements ausgewählt wird. Mit der SelectionFont-Eigenschaft können Sie Text fett oder kursiv formatieren. Mit dieser Eigenschaft können Sie auch die Größe und die Schriftart des Texts ändern. Mit der SelectionColor-Eigenschaft können Sie die Textfarbe ändern. Verwenden Sie die SelectionBullet-Eigenschaft zum Erstellen von Aufzählungen. Sie können auch die Absatzformatierung anpassen, indem Sie die SelectionIndent-Eigenschaft, die SelectionRightIndent-Eigenschaft und die SelectionHangingIndent-Eigenschaft festlegen.

Das RichTextBox-Steuerelement stellt Methoden bereit, die Funktionen zum Öffnen und Speichern von Dateien bereitstellen. Mit der LoadFile-Methode können Sie eine vorhandene RTF-Datei oder ASCII-Textdatei in das Steuerelement laden. Sie können auch Daten aus einem bereits geöffneten Datenstream laden. Mit SaveFile können Sie eine Datei als RTF-Text oder ASCII-Text speichern. Ähnlich der LoadFile-Methode können Sie auch mit der SaveFile-Methode Daten in einem geöffneten Datenstream speichern. Das RichTextBox-Steuerelement stellt auch Features zum Suchen von Textzeichenfolgen bereit. Die Find-Methode wird überladen, um sowohl Textzeichenfolgen als auch spezifische Zeichen im Text des Steuerelements zu suchen.

Sie können das RichTextBox-Steuerelement auch mit im Speicher befindlichen Daten initialisieren. Beispielsweise können Sie die Rtf-Eigenschaft mit einer Zeichenfolge initialisieren, die den anzuzeigenden Text und RTF-Codes enthält, die die Formatierung des Texts bestimmen.

Wenn der Text im Steuerelement Verknüpfungen enthält, z. B. auf eine Website, können Sie die Verknüpfung mithilfe der DetectUrls-Eigenschaft an entsprechender Stelle im Text des Steuerelements anzeigen lassen. Dann können Sie das LinkClicked-Ereignis behandeln, um die der Verknüpfung zugeordneten Tasks auszuführen. Mit der SelectionProtected-Eigenschaft können Sie Text im Steuerelement vor Änderungen durch Benutzer schützen. Bei geschütztem Text im Steuerelement können Sie das Protected-Ereignis behandeln, um festzustellen, wenn ein Benutzer versucht hat, geschützten Text zu ändern. Somit können Sie den Benutzer darauf hinweisen, dass es sich um geschützten Text handelt, oder ihm ein Standardverfahren zum Ändern des geschützten Texts zur Verfügung stellen.

Anwendungen, die bereits TextBox-Steuerelemente verwenden, können auf einfache Weise für die Verwendung von RichTextBox-Steuerelementen angepasst werden. Das RichTextBox-Steuerelement weist jedoch nicht dieselbe Kapazitätsgrenze von 64.000 Zeichen wie das TextBox-Steuerelement auf. RichTextBox wird üblicherweise zum Bereitstellen von Features zur Textänderung und Anzeige verwendet, die Textverarbeitungsanwendungen wie Microsoft Word ähneln.

Hinweis

Die TextBoxBase.Undo-Methode kann weder für das KeyPress-Ereignis noch für das TextChanged-Ereignis verwendet werden.

Beispiel

Im folgenden Codebeispiel wird ein RichTextBox-Steuerelement erstellt, das eine RTF-Datei in das Steuerelement lädt und nach der ersten Instanz des Worts "Text" sucht. Der Code ändert dann den Schriftschnitt, den Schriftgrad, die Schriftfarbe des markierten Texts und speichert die Änderungen in der ursprünglichen Datei. Der Beispielcode beendet den Vorgang, indem das Steuerelement dem entsprechenden Form hinzugefügt wird. Für dieses Beispiel ist es erforderlich, dass die im Beispielcode erstellte Methode einer Form-Klasse hinzugefügt und aus dem Konstruktor des Formulars aufgerufen wird. Für das Beispiel ist es außerdem erforderlich, dass eine RTF-Datei, die das Wort "Text" enthält, im Stammverzeichnis des Laufwerks C erstellt wird.

Public Sub CreateMyRichTextBox()
    Dim richTextBox1 As New RichTextBox()
    richTextBox1.Dock = DockStyle.Fill
    
    
    richTextBox1.LoadFile("C:\MyDocument.rtf")
    richTextBox1.Find("Text", RichTextBoxFinds.MatchCase)
    
    richTextBox1.SelectionFont = New Font("Verdana", 12, FontStyle.Bold)
    richTextBox1.SelectionColor = Color.Red
    
    richTextBox1.SaveFile("C:\MyDocument.rtf", RichTextBoxStreamType.RichText)
    
    Me.Controls.Add(richTextBox1)
End Sub

public void CreateMyRichTextBox()
{
    RichTextBox richTextBox1 = new RichTextBox();
    richTextBox1.Dock = DockStyle.Fill;


    richTextBox1.LoadFile("C:\\MyDocument.rtf");
    richTextBox1.Find("Text", RichTextBoxFinds.MatchCase);

    richTextBox1.SelectionFont = new Font("Verdana", 12, FontStyle.Bold);
    richTextBox1.SelectionColor = Color.Red;

    richTextBox1.SaveFile("C:\\MyDocument.rtf", RichTextBoxStreamType.RichText);

    this.Controls.Add(richTextBox1);
}

public:
   void CreateMyRichTextBox()
   {
      RichTextBox^ richTextBox1 = gcnew RichTextBox;
      richTextBox1->Dock = DockStyle::Fill;

      richTextBox1->LoadFile( "C:\\MyDocument.rtf" );
      richTextBox1->Find( "Text", RichTextBoxFinds::MatchCase );

      richTextBox1->SelectionFont = gcnew System::Drawing::Font(
         "Verdana", 12, FontStyle::Bold );
      richTextBox1->SelectionColor = Color::Red;

      richTextBox1->SaveFile( "C:\\MyDocument.rtf",
         RichTextBoxStreamType::RichText );

      this->Controls->Add( richTextBox1 );
   }

public void CreateMyRichTextBox()
{
    RichTextBox richTextBox1 = new RichTextBox();

    richTextBox1.set_Dock(DockStyle.Fill);
    richTextBox1.LoadFile("C:\\MyDocument.rtf");
    richTextBox1.Find("Text", RichTextBoxFinds.MatchCase);
    richTextBox1.set_SelectionFont(new Font
        ("Verdana", 12, FontStyle.Bold));
    richTextBox1.set_SelectionColor(Color.get_Red());
    richTextBox1.SaveFile("C:\\MyDocument.rtf",
        RichTextBoxStreamType.RichText);
    this.get_Controls().Add(richTextBox1);
} //CreateMyRichTextBox

Vererbungshierarchie

System.Object
   System.MarshalByRefObject
     System.ComponentModel.Component
       System.Windows.Forms.Control
         System.Windows.Forms.TextBoxBase
          System.Windows.Forms.RichTextBox

Threadsicherheit

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

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-Member
System.Windows.Forms-Namespace
TextBoxBase
TextBox