WinForm中RichTextBox控件詳解：從基礎到高級應用
上一文中筆者重點介紹了TextBox控件的詳細用法，忘記的 請點擊WinForm真入門(8)——TextBox控件詳解，那么本文中的RichTextBox與TextBox有什么區別嗎，光看名字的話，多了一個“Rich 富有的意思”,是不是暗示著它支持的功能更多呢？沒錯，RichTextBox是WinForm中功能強大的富文本編輯控件，支持字體、顏色、段落格式、圖像嵌入、超鏈接等復雜功能。以下從基礎到高級功能全面解析，并提供多個實用案例。
一、基礎屬性與核心功能?
?1、基礎屬性?
- Text?：獲取或設置純文本內容。
richTextBox1.Text = "Hello World";
- ?Rtf?：獲取或設置帶格式的RTF內容。
richTextBox1.Rtf = @"{\rtf1\ansi 這是\b 加粗\b0 的文本}";
- ?SelectionFont?：設置選中文本的字體樣式。
richTextBox1.SelectionFont = new Font("Arial", 12, FontStyle.Bold);
- ?SelectionColor?：設置選中文本的顏色。
richTextBox1.SelectionColor = Color.Red;
- ?SelectionAlignment?：設置段落對齊方式（左對齊、居中、右對齊）。
richTextBox1.SelectionAlignment = HorizontalAlignment.Center;
2?、常用方法?
- ?AppendText?：追加文本（保留當前格式）。
richTextBox1.AppendText("\n新的一行");
- ?LoadFile/SaveFile?：加載或保存RTF文件。
richTextBox1.LoadFile("document.rtf");
richTextBox1.SaveFile("document.rtf", RichTextBoxStreamType.RichText);
- ?Find?：查找文本。
int index = richTextBox1.Find("關鍵字");
if (index >= 0) richTextBox1.Select(index, "關鍵字".Length);
3?、關鍵事件?
- ?TextChanged?：文本內容變化時觸發。
private void richTextBox1_TextChanged(object sender, EventArgs e) { }
- ?SelectionChanged?：選中文本范圍變化時觸發。
private void richTextBox1_SelectionChanged(object sender, EventArgs e)
{label1.Text = $"當前選中：{richTextBox1.SelectionLength}字符";
}
?二、高級功能與案例?
?案例1：實現富文本編輯器?
// 字體選擇
private void btnFont_Click(object sender, EventArgs e)
{FontDialog fontDialog = new FontDialog();if (fontDialog.ShowDialog() == DialogResult.OK){richTextBox1.SelectionFont = fontDialog.Font;}
}// 顏色選擇
private void btnColor_Click(object sender, EventArgs e)
{ColorDialog colorDialog = new ColorDialog();if (colorDialog.ShowDialog() == DialogResult.OK){richTextBox1.SelectionColor = colorDialog.Color;}
}// 插入圖片（通過剪貼板）
private void btnInsertImage_Click(object sender, EventArgs e)
{OpenFileDialog openFile = new OpenFileDialog();openFile.Filter = "圖片文件|*.jpg;*.png;*.bmp";if (openFile.ShowDialog() == DialogResult.OK){Clipboard.SetImage(Image.FromFile(openFile.FileName));richTextBox1.Paste();}
}
?案例2：動態設置段落縮進與項目符號?
// 增加縮進
private void btnIndent_Click(object sender, EventArgs e)
{richTextBox1.SelectionIndent += 20;
}// 添加項目符號
private void btnBullet_Click(object sender, EventArgs e)
{richTextBox1.SelectionBullet = true;richTextBox1.AppendText("項目1\n項目2\n");
}
?案例3：實現超鏈接與點擊事件?
// 插入超鏈接
private void InsertHyperlink(string text, string url)
{richTextBox1.SelectionColor = Color.Blue;richTextBox1.SelectionFont = new Font("Arial", 10, FontStyle.Underline);richTextBox1.AppendText(text);richTextBox1.SelectionStart = richTextBox1.Text.Length - text.Length;richTextBox1.SelectionLength = text.Length;richTextBox1.SelectionLink = true;// 存儲URL到TagrichTextBox1.Tag = url;
}// 處理超鏈接點擊
private void richTextBox1_LinkClicked(object sender, LinkClickedEventArgs e)
{System.Diagnostics.Process.Start(e.LinkText);
}
?案例4：日志顯示（不同顏色區分信息類型）?
public void LogMessage(string message, LogLevel level)
{Color color = Color.Black;switch (level){case LogLevel.Info: color = Color.Blue; break;case LogLevel.Warn: color = Color.Orange; break;case LogLevel.Error: color = Color.Red; break;}richTextBox1.SelectionColor = color;richTextBox1.AppendText($"{DateTime.Now}: {message}\n");richTextBox1.ScrollToCaret(); // 自動滾動到底部
}
?案例5：實現撤銷(Undo)與重做(Redo)?
private void btnUndo_Click(object sender, EventArgs e)
{if (richTextBox1.CanUndo){richTextBox1.Undo();richTextBox1.ClearUndo(); // 防止重復撤銷}
}private void btnRedo_Click(object sender, EventArgs e)
{// 需自行維護重做棧（RichTextBox無原生Redo方法）// 可通過繼承控件或記錄操作歷史實現
}
?三、性能優化與高級技巧?
1?、大量文本處理優化?
- 掛起繪制?：在批量操作時暫停繪制以提升性能。
SendMessage(richTextBox1.Handle, WM_SETREDRAW, false, 0);
// 執行批量文本操作...
SendMessage(richTextBox1.Handle, WM_SETREDRAW, true, 0);
richTextBox1.Invalidate();
2?、防閃爍處理?
- ?自定義控件啟用雙緩沖?：
public class NoFlickerRichTextBox : RichTextBox
{public NoFlickerRichTextBox(){SetStyle(ControlStyles.OptimizedDoubleBuffer | ControlStyles.AllPaintingInWmPaint, true);}
}
3?、異步加載內容?
- 使用Task避免界面卡頓：
private async void LoadLargeFile(string path)
{string rtfContent = await Task.Run(() => File.ReadAllText(path));richTextBox1.Rtf = rtfContent;
}
?四、與其他控件交互?
?案例6：與TreeView聯動實現大綱視圖?
// 根據標題生成目錄
private void GenerateOutline()
{treeView1.Nodes.Clear();foreach (string line in richTextBox1.Lines){if (line.StartsWith("# ")){TreeNode node = new TreeNode(line.Substring(2));treeView1.Nodes.Add(node);}}
}// 點擊目錄跳轉到對應位置
private void treeView1_AfterSelect(object sender, TreeViewEventArgs e)
{int index = richTextBox1.Find(e.Node.Text);if (index != -1){richTextBox1.SelectionStart = index;richTextBox1.ScrollToCaret();}
}
?案例7：與WebBrowser控件協同顯示HTML?
// 將RTF轉換為HTML顯示（需第三方庫如PanGu.RTF）
private void btnPreviewHtml_Click(object sender, EventArgs e)
{string html = ConvertRtfToHtml(richTextBox1.Rtf);webBrowser1.DocumentText = html;
}
?五、數據持久化與擴展?
1?、保存與加載格式?
- RTF格式?：保留所有樣式。
richTextBox1.SaveFile("doc.rtf", RichTextBoxStreamType.RichText);
- ?純文本格式?：僅保留文本內容。
File.WriteAllText("doc.txt", richTextBox1.Text);
2?、擴展：實現Markdown編輯器?
- 使用正則表達式轉換Markdown與RTF：
// 轉換加粗語法：‌**text**‌ → \b text\b0
string rtf = Regex.Replace(markdown, @"\*\*(.*?)\*\*", @"\b $1\b0");
?六、常見問題與解決方案?
?1、圖片顯示不全?
- 原因：圖片過大導致布局溢出。
- 解決：縮放圖片至合適尺寸后再插入。
Image img = Image.FromFile("large.jpg");
Bitmap resized = new Bitmap(img, new Size(200, 200));
Clipboard.SetImage(resized);
richTextBox1.Paste();
2?、跨平臺格式兼容性?
- 問題：在不同系統上RTF渲染不一致。
- 解決：盡量使用通用字體（如Arial、Times New Roman）。
3?、超鏈接無法點擊?
- 檢查：確保DetectUrls屬性為true，并處理LinkClicked事件。
richTextBox1.DetectUrls = true;
七、使用建議
1?、核心場景?：
- 需要富文本編輯（如郵件客戶端、文檔編輯器）。
- 動態顯示格式化的日志或聊天記錄。
- 復雜報表的內容生成與預覽。
2?、避坑指南?：
- 避免直接操作Rtf屬性拼接復雜格式，優先使用SelectionXXX方法。
- 處理大量文本時，務必使用掛起繪制技術提升性能。
- 謹慎使用剪貼板操作，需處理權限和異常。
