Avec le contrôle RichTextBox, l'utilisateur peut entrer et modifier du texte. Le contrôle fournit également des fonctionnalités de mise en forme plus avancées que le contrôle TextBox standard. Le texte peut être assigné directement au contrôle ou être chargé à partir d'un fichier RTF (Rich Text Format) ou d'un fichier en texte brut. Il est possible d'assigner une mise en forme, au niveau des caractères et des paragraphes, au texte contenu dans le contrôle.

Le contrôle RichTextBox fournit un certain nombre de propriétés qui permettent d'appliquer une mise en forme à n'importe quelle portion du texte contenu dans le contrôle. Pour modifier la mise en forme du texte, il faut commencer par sélectionner ce texte. La mise en forme des caractères et des paragraphes ne peut être assignée qu'à du texte sélectionné. Une fois qu'un paramètre de mise en forme a été appliqué à une section de texte sélectionnée, tout le texte entré après cette section reçoit la même mise en forme jusqu'à ce qu'une modification de paramètre ait lieu ou qu'une section différente du document du contrôle soit sélectionnée. La propriété SelectionFont vous permet d'appliquer au texte le style gras ou italique. Vous pouvez également utiliser cette propriété pour modifier la taille et la police du texte. La propriété SelectionColor vous permet de modifier la couleur du texte. Pour créer des listes à puces, utilisez la propriété SelectionBullet. Vous pouvez également modifier la mise en forme des paragraphes en définissant les propriétés SelectionIndent, SelectionRightIndent et SelectionHangingIndent.

Le contrôle RichTextBox fournit des méthodes qui offrent des fonctionnalités d'ouverture et d'enregistrement de fichiers. La méthode LoadFile permet de charger un fichier texte ASCII ou RTF dans le contrôle. Vous pouvez également charger des données à partir d'un flux de données déjà ouvert. La méthode SaveFile permet d'enregistrer un fichier en format texte ASCII ou RTF. Sur le modèle de la méthode LoadFile, vous pouvez utiliser SaveFile pour enregistrer des données dans un flux de données ouvert. Le contrôle RichTextBox fournit également des fonctionnalités permettant de rechercher des chaînes de texte. La méthode Find est surchargée pour trouver des chaînes de texte comme des caractères spécifiques dans le texte du contrôle.

Vous pouvez également initialiser le contrôle RichTextBox aux données stockées en mémoire. Par exemple, vous pouvez initialiser la propriété Rtf à une chaîne qui contient le texte à afficher, y compris les codes RTF qui déterminent la façon dont le texte doit être mis en forme.

Si le contrôle contient des liens (par exemple, un lien vers un site Web), la propriété DetectUrls permet d'afficher correctement ces liens dans le texte du contrôle. Vous pouvez ensuite gérer l'événement LinkClicked pour effectuer les tâches associées aux liens. La propriété SelectionProtected permet de protéger le texte du contrôle contre les manipulations de l'utilisateur. Lorsque vous avez protégé le texte d'un contrôle, vous avez la possibilité de gérer l'événement Protected pour déterminer quand l'utilisateur a essayé de modifier le texte protégé et avertir l'utilisateur que ce texte est protégé ou lui indiquer un moyen standard pour manipuler le texte protégé.

Les applications qui utilisent déjà des contrôles TextBox peuvent facilement s'adapter aux contrôles RichTextBox. Toutefois, le contrôle RichTextBox ne présente pas la même limite de capacité (64 Ko) que le contrôle TextBox. RichTextBox est généralement utilisé pour fournir des fonctionnalités de manipulation et d'affichage de texte analogues aux applications de traitement de texte telles que Microsoft Word.

Remarque
La méthode TextBoxBase.Undo ne fonctionne pas avec les événements KeyPress ou TextChanged.

L'exemple de code suivant crée un contrôle RichTextBox qui charge un fichier RTF dans le contrôle et recherche la première occurrence du mot "Text". Le code modifie ensuite le style, la taille et la couleur de police du texte sélectionné et enregistre les modifications dans le fichier d'origine. Enfin, l'exemple ajoute le contrôle à un Form. L'exemple suppose que la méthode créée dans cet exemple de code est ajoutée à une classe Form et appelée à partir du constructeur du formulaire. Cet exemple suppose également qu'un fichier RTF contenant le mot "Text" est créé à la racine du lecteur C.

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

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile pour Pocket PC, Windows Mobile pour Smartphone, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework