C# RichTextBox控件核心用法指南

核心功能概览

RichTextBox 控件是 Windows Forms 中的重要组件，它除了具备 TextBox 的所有基础功能外，还提供了以下高级特性：

• 多格式支持：能够以 RTF (Rich Text Format) 和普通 ASCII 文本格式打开和保存文件。
• 格式化能力：可以对选定文本进行字体粗细、倾斜、下划线、颜色、上标/下标等格式设置，并支持段落的缩进调整。
• OLE 对象嵌入：支持通过拖放或剪贴板嵌入其他应用程序创建的 OLE 对象（如 Excel 表格、Word 文档）。
• 数据绑定：可绑定到数据库中的 Binary 或 Memo 字段，常用于存储富文本内容。
• 打印支持：提供 SelPrint 方法，允许打印控件内的部分或全部文本。

注意：在使用该控件前，确保项目中已正确引用 System.Windows.Forms 命名空间。现代 .NET 项目中该控件为默认内置，无需像旧版本那样手动注册 Richtx32.ocx 文件。

文档加载与保存

RichTextBox 最基础的用途是作为富文本文档的编辑器。使用 LoadFile 和 SaveFile 方法可以便捷地实现文件的读写。

第1步：加载文本或 RTF 文件

目的：将外部文件或字符串内容显示在控件中。
入口：按钮点击事件或表单加载事件。
动作：调用 LoadFile 方法，根据文件格式指定 RichTextBoxStreamType。

// 示例：从指定路径加载纯文本文件
private void buttonLoad_Click(object sender, EventArgs e)
{
    try
    {
        // LoadFile 需要指定流的类型
        richTextBox1.LoadFile(@"..\..\test.txt", RichTextBoxStreamType.PlainText);
    }
    catch (System.IO.FileNotFoundException)
    {
        MessageBox.Show("未找到文件！");
    }
}

如果加载的是 RTF 格式的文件，可以将第二个参数更改为 RichTextBoxStreamType.RichText。

第2步：保存当前文档

目的：将用户在控件中输入或修改的内容持久化到磁盘。
动作：调用 SaveFile 方法。

// 示例：保存为纯文本文件
private void btnSave_Click(object sender, EventArgs e)
{
    try
    {
        richTextBox1.SaveFile(@"..\..\output.txt", RichTextBoxStreamType.PlainText);
    }
    catch (Exception err)
    {
        MessageBox.Show(err.Message);
    }
}

文本格式化操作

要对文本进行格式化，首先必须选中目标文本。选中后，可以通过修改 SelectionFont、SelectionAlignment 等属性来应用样式。

第3步：切换粗体、斜体和下划线

目的：实现类似 Word 的加粗、斜体开关按钮效果。
入口：工具栏或按钮点击事件。
动作：获取当前选择文本的字体样式，按位运算切换对应标志位，再重新赋值给 SelectionFont。

// 切换粗体状态
private void btnBold_Click(object sender, EventArgs e)
{
    Font oldFont = richTextBox1.SelectionFont;
    FontStyle newStyle;
    
    // 检查是否已经加粗
    if ((oldFont.Style & Font.Bold) == Font.Bold)
        newStyle = oldFont.Style ^ Font.Bold; // 取消粗体
    else
        newStyle = oldFont.Style | Font.Bold; // 添加粗体
    
    // 创建新字体并应用
    richTextBox1.SelectionFont = new Font(oldFont.FontFamily, oldFont.Size, newStyle);
    richTextBox1.Focus();
}

// 切换斜体状态
private void btnItalic_Click(object sender, EventArgs e)
{
    Font oldFont = richTextBox1.SelectionFont;
    FontStyle newStyle;
    
    if ((oldFont.Style & Font.Italic) == Font.Italic)
        newStyle = oldFont.Style ^ Font.Italic;
    else
        newStyle = oldFont.Style | Font.Italic;
        
    richTextBox1.SelectionFont = new Font(oldFont.FontFamily, oldFont.Size, newStyle);
    richTextBox1.Focus();
}

第4步：设置段落对齐方式

目的：调整选中文本的对齐格式（左对齐、居中、右对齐）。
参数：使用 HorizontalAlignment 枚举值。

// 切换居中对齐
private void btnCenter_Click(object sender, EventArgs e)
{
    if (richTextBox1.SelectionAlignment == HorizontalAlignment.Center)
        richTextBox1.SelectionAlignment = HorizontalAlignment.Left;
    else
        richTextBox1.SelectionAlignment = HorizontalAlignment.Center;
    richTextBox1.Focus();
}

第5步：动态调整字体大小

目的：根据用户输入的数字实时改变选定文本的大小。
动作：解析输入的字符串转换为浮点数，构建新的 Font 对象。

public void ApplyTextSize(float newSize)
{
    FontFamily currentFamily = richTextBox1.SelectionFont.FontFamily;
    FontStyle style = richTextBox1.SelectionFont.Style;
    
    // 防止字号过小导致异常，可做最小值判断
    if(newSize > 0)
    {
        richTextBox1.SelectionFont = new Font(currentFamily, newSize, style);
    }
}

内容搜索与高亮

RichTextBox 提供了强大的 Find 方法用于在文档中查找文本，这比遍历字符效率更高。

第6步：基础字符串搜索

目的：在控件全文中查找特定的关键词。
结果：返回找到的第一个字符索引；若未找到则返回 -1。同时会自动选中该区域。

// 简单的字符串查找
int index = richTextBox1.Find("关键字");
if (index >= 0)
{
    MessageBox.Show($"找到文本，位于索引 {index}");
}

第7步：启用选项的高级搜索

目的：区分大小写、向后搜索或在指定范围内搜索。
参数：使用 RichTextBoxFinds 枚举。

public bool FindAndHighlight(string textToFind)
{
    bool found = false;
    if (!string.IsNullOrEmpty(textToFind))
    {
        // 参数1: 要查找的文本
        // 参数2: 搜索标志 (如 MatchCase 区分大小写)
        int index = richTextBox1.Find(textToFind, RichTextBoxFinds.MatchCase);
        
        if (index >= 0)
        {
            // 找到后会自动选中，可在此处做高亮或其他处理
            found = true;
        }
    }
    return found;
}

第8步：在指定范围内搜索

目的：限制搜索范围，避免搜索全篇或重复搜索已查过的区域。
动作：重载版本 Find(string, int start, int end, RichTextBoxFinds)。

// 从索引 100 到 500 的位置搜索
int startIndex = 100;
int endIndex = 500;
int foundIndex = richTextBox1.Find("目标词", startIndex, endIndex, RichTextBoxFinds.None);

链接交互

RichTextBox 可以识别 URL 并自动变为蓝色下划线链接。通过订阅 LinkClicked 事件，可以实现点击链接跳转浏览器。

private void richTextBox1_LinkClicked(object sender, LinkClickedEventArgs e)
{
    // 使用默认程序打开链接
    System.Diagnostics.Process.Start(e.LinkText);
}

排错与维护

• 编译找不到控件：请确认项目类型为 Windows Forms Application。如果是 WPF 项目，应使用 RichTextBox 类，其 API 差异较大，需查阅 WPF 文档。
• 内存溢出：RichTextBox 处理超大文本时性能较差。建议超过几十万字符的内容考虑分页加载或切换到专门的文本编辑器控件。
• 编码乱码：在保存纯文本时，默认可能使用系统当前编码。如果需要指定 UTF-8 等编码，建议使用 File.WriteAllText 结合 GetTextRange 手动提取文本内容后进行写入，而不是直接使用 SaveFile。

总结

C# 中的 RichTextBox 是一个功能全面的富文本编辑器基类。通过合理运用 LoadFile/SaveFile 处理文件流，利用 SelectionFont 管理样式，以及 Find 方法进行精准检索，您可以快速开发出具备专业文字排版能力的桌面应用。以上就是 C# WinForms 中 RichTextBox 控件使用的详细内容，更多关于 C# 界面开发实战的资料请关注本站其它相关文章！