【C#】RichTextBox基本用法和高级用法及示例

在 Windows Forms 应用程序中，RichTextBox 是一个非常强大的控件，可以用来处理多行文本输入和输出。与普通的 TextBox 不同，RichTextBox 支持富文本格式，比如字体样式、颜色和对齐方式。

---

基本用法

1. 拖放控件

   • 在 Visual Studio 中，打开你的 Windows Forms Designer。
   • 从工具箱中找到 RichTextBox，拖放到你的窗体中。

2. 常见属性：

   • Text：设置或获取控件中的文本内容。
   • ReadOnly：是否为只读模式。
   • Multiline：是否允许多行文本（默认就是 true）。
   • ScrollBars：控制滚动条显示（例如RichTextBoxScrollBars.Vertical）。

3. 代码示例：

// 添加文本到 RichTextBox
richTextBox1.Text = "Hello, this is a RichTextBox example!";// 追加文本
richTextBox1.AppendText("\nAppending some more text...");// 设置为只读
richTextBox1.ReadOnly = true;// 获取内容
string currentText = richTextBox1.Text;
MessageBox.Show(currentText);

---

高级用法

1. 富文本格式
   • 通过 SelectionFont、SelectionColor、SelectionAlignment 等属性，可以对选定的文本进行格式化。

// 设置选中文本的字体
richTextBox1.SelectionFont = new Font("Arial", 12, FontStyle.Bold);// 设置选中文本的颜色
richTextBox1.SelectionColor = Color.Red;// 设置选中文本的对齐方式
richTextBox1.SelectionAlignment = HorizontalAlignment.Center;

2. 加载和保存文件
   • RichTextBox 支持加载和保存 .txt 或 .rtf 格式文件。

// 保存到 RTF 文件
richTextBox1.SaveFile("example.rtf", RichTextBoxStreamType.RichText);// 加载 RTF 文件
richTextBox1.LoadFile("example.rtf", RichTextBoxStreamType.RichText);// 保存到纯文本文件
richTextBox1.SaveFile("example.txt", RichTextBoxStreamType.PlainText);

3. 处理事件
   • 监听用户输入或操作。

private void richTextBox1_TextChanged(object sender, EventArgs e)
{MessageBox.Show("Text changed!");
}

4. 插入图片
   • 在 RichTextBox 中可以通过 Clipboard 来插入图片。

// 将图片加载到剪贴板
Image img = Image.FromFile("example.jpg");
Clipboard.SetImage(img);// 将图片插入到 RichTextBox
richTextBox1.Paste();

---

** 示例1**

下面是一个完整的例子，包括文本操作、格式化和文件保存。

using System;
using System.Drawing;
using System.Windows.Forms;public class RichTextBoxExample : Form
{private RichTextBox richTextBox1;private Button btnSave, btnLoad, btnFormat;public RichTextBoxExample(){this.Text = "RichTextBox 示例";this.Size = new Size(500, 400);// 初始化 RichTextBoxrichTextBox1 = new RichTextBox();richTextBox1.Dock = DockStyle.Top;richTextBox1.Height = 200;// 保存按钮btnSave = new Button();btnSave.Text = "保存文本";btnSave.Click += (s, e) =>{richTextBox1.SaveFile("example.rtf", RichTextBoxStreamType.RichText);MessageBox.Show("文本已保存！");};// 加载按钮btnLoad = new Button();btnLoad.Text = "加载文本";btnLoad.Click += (s, e) =>{richTextBox1.LoadFile("example.rtf", RichTextBoxStreamType.RichText);MessageBox.Show("文本已加载！");};// 格式化按钮btnFormat = new Button();btnFormat.Text = "设置格式";btnFormat.Click += (s, e) =>{richTextBox1.SelectionFont = new Font("Comic Sans MS", 14, FontStyle.Italic);richTextBox1.SelectionColor = Color.Blue;};// 布局var panel = new FlowLayoutPanel();panel.Dock = DockStyle.Bottom;panel.Height = 50;panel.Controls.Add(btnSave);panel.Controls.Add(btnLoad);panel.Controls.Add(btnFormat);// 添加控件到窗体this.Controls.Add(richTextBox1);this.Controls.Add(panel);}[STAThread]public static void Main(){Application.Run(new RichTextBoxExample());}
}

---

小结

RichTextBox 是一个功能强大的控件，适用于需要处理多格式文本的应用场景，例如文档编辑器、聊天界面等。根据需求可以灵活设置格式，甚至支持图文混排。