C# Richtextbox 创建、设置字体颜色、添加删除读取行、每行显示指定字数、修改选中文字颜色、用红色标出行
Richtextbox 是 C# 中的富文本编辑框，用于编辑内容比较多的文本，当然也可以用它显示文本，只要把它的背景颜色设置为与它所在控件的背景一致。Richtextbox 创建有两种方法，一种为用控件创建，另一种为用代码创建。它有很多属性，设置或修改它们既可在“属性”窗口又可用代码，本文主要探讨后者。
设置或修改 Richtextbox 字体颜色，既可用具体的颜色名称又可用RGB。Richtextbox 显示的行数与换行符分隔的行数不是一个概念，它的属性 lines 是指后者，而添加删除读取行和每行显示指定字数都是指前者。若要突出显示选中文字，可以用高亮的颜色或大的字体显示，也可以同时用两者；除可标出一行或几行外，还可标出某个指定词组。
一、C# Winform Richtextbox 的创建
1、从“工具箱”创建。把“工具箱”中的 Richtextbox 拖到窗体就创建了一个 Richtextbox 控件。
2、用代码创建。
创建一个 Richtextbox 控件，同时定义几个属性，然后把它添加到现有窗体，代码如下：
using System.Drawing;
using System.Windows.Forms;
private void CreateRichTextBox()
{
RichTextBox richTextBox1 = new RichTextBox
{
Dock = DockStyle.None,// 不填充，若要填整个窗体，用 Dock = DockStyle.Fill
Font = new Font("Cambria", 10),
ForeColor = Color.Gray,
Size = new Size(600, 400)
};
richTextBox1.Text = "创建一个 richTextBox 控件";
richTextBox1.Location = new Point(10, 10);
this.Controls.Add(richTextBox1);
}
如果要把创建的 Richtextbox 控件添加到一个新建的窗体，只需把 this.Controls.Add(richTextBox1); 改为如下代码：
Form frm = new Form { Controls = { richTextBox1 } };
frm.Width = 670;
frm.Height = 520;
frm.ShowDialog();
在窗体构造函数中调用：
public richtext()
{
InitializeComponent();
CreateRichTextBox();
}
二、C# Winform Richtextbox 的属性设置
1、Richtextbox 字体颜色
创建 Richtextbox 时可以定义字体颜色，如以上的 ForeColor = Color.Gray；也可以创建 Richtextbox 后定义，代码如下：
richTextBox1.ForeColor = Color.DimGray;
或
richTextBox1.ForeColor = Color.FromArgb(255, 108, 105, 105);
FromArgb 的第一个参数为 alpha（透明度），后三个参数为 R、G、B（红、绿、蓝）。
2、Richtextbox 字体大小
Font f = new Font("宋体", 10F, FontStyle.Regular, GraphicsUnit.Point);
richTextBox1.Font = f;
如果要设置为粗体，只需把 FontStyle.Regular 改为 FontStyle.Bold，即：
Font f = new Font("宋体", 10F, FontStyle.Bold, GraphicsUnit.Point);
3、Richtextbox 的比例因子 ZoomFactor
修改 ZoomFactor，文字和行高会自动增大，例如把它的值改为 1.2，见如下代码：
richTextBox1.ZoomFactor = (float)1.2;
效果如图1所示：
图1
三、C# Winform Richtextbox 行
（一）Richtextbox 添加和插入新行
1、添加新行到最后
（1）只添加空行
richTextBox1.AppendText( Environment.NewLine); 或 richTextBox1.AppendText("\r\n");
（2）添加一行文字
richTextBox1.AppendText("Richtextbox 添加新行\r\n");
\r\n 为换行符，放在后表示在文字后换行；如果要在文字前换行，把它放到文字前即可。
2、插入新行
插入新行到第一行：
richTextBox1.Text = richTextBox1.Text.Insert(0, "插入新行到第一行\r\n");
0 表示插入到第一行，如果要插入到其它行，把 0 改为相应行号，例如插入到第 6 行，把 0 改为 6 即可。
3、如果 RichTextBox 的内容为空，添加到第一行，否则添加末尾，代码如下：
private void AddTextIntoRichTextBox(string text)
{
if (String.IsNullOrEmpty(richTextBox1.Text))
richTextBox1.AppendText(text);
else
richTextBox1.AppendText( Environment.NewLine + text);
richTextBox1.ScrollToCaret();//把控件内容滚动到当前插入符号位置
}
（二）C# Winform Richtextbox 添加新行且文字为彩色
假如要把一行文字显示为三种颜色。添加文本仍用 AppendText 方法，但默认方法没有此功能，需要重载扩展，代码如下：
using System;
using System.Windows.Forms;
using System.Drawing;
namespace PublicClass
{
public static class RichTextBoxColorExtensions
{
public static void AppendText(this RichTextBox rtb, string text, Color color, Font font, bool isNewLine = false)
{
rtb.SuspendLayout();
rtb.SelectionStart = rtb.TextLength;
rtb.SelectionLength = 0;
rtb.SelectionColor = color;
rtb.SelectionFont = font;
rtb.AppendText(isNewLine ? $"{text}{ Environment.NewLine}" : text);
rtb.SelectionColor = rtb.ForeColor;
rtb.ScrollToCaret();
rtb.ResumeLayout();
}
}
}
// 添加新行且文字为彩色
private void DifferentColorRichTextBox()
{
string text = "沙糖桔|6元/斤|2050千克||龙眼|5元/斤|685千克||香蕉|4.5元/斤|1258千克";
string[] arr = text.Split(new string[] { "||" }, StringSplitOptions.RemoveEmptyEntries);
Font font = new Font("宋体", 12);
string[] subArr;
for (int i = 0; i < arr.Length; i++)
{
subArr = arr[i].Split('|');
richTextBox1.AppendText(subArr[0], Color.Fuchsia, font);
richTextBox1.AppendText("：");
richTextBox1.AppendText(subArr[1], Color.Green, font);
richTextBox1.AppendText(" ");
richTextBox1.AppendText(subArr[2], Color.Blue, font, true);
}
}
在窗体构造函数中调用：
public richtext()
{
InitializeComponent();
DifferentColorRichTextBox();
}
效果如图2所示：
图2
（三）C# Winform Richtextbox 滚动到最后一行
richTextBox1.SelectionStart = richTextBox1.TextLength;//或 richTextBox1.Select(richTextBox1.TextLength, 0);
richTextBox1.ScrollToCaret();
richTextBox1.AppendText(richTextBox1.Text);
（四）C# Winform Richtextbox 行数
1、RichTextBox.Lines 含义
RichTextBox.Lines 是指“属性”窗口中 Text 右边的文字行数，不是指窗体中的文字行数。假如在 RichTextBox1 中有两行文字，如图3所示：
图3
用代码：
int n = richTextBox1.Lines.Length;
AddTextIntoRichTextBox(n.ToString());//调用上面的方法
显示它的行数，结果显示 2，如图4所示：
图4
2、逐行读取 RichTextBox.Lines 文本
private void ReadTextInRichTextBox()
{
foreach(string l in richTextBox1.Lines)
{
MessageBox.Show(l);
}
}
3、读取指定行
假如要读取包含 Winform 的行，代码如下：
private string ReadSpecificLineInRichTextBox(string specificText)
{
// 查找指定文字所在的位置
int pos = richTextBox1.Find(specificText, RichTextBoxFinds.MatchCase);
if (pos != -1)
{
// 根据指定文字所在的位置返回行号
int lineNum = richTextBox1.GetLineFromCharIndex(pos);
string text = richTextBox1.Lines.ElementAt(lineNum);
return text;
}
return null;
}
调用：
ReadSpecificLineInRichTextBox("Winform");
也可以用兰姆达表达式（Lambda）实现，代码如下：
private string ReadSpecificLineInRichTextBox(string specificText)
{
return richTextBox1.Lines.FirstOrDefault(l => l.Contains(specificText));
}
4、RichTextBox 仅显示前 n 行
（1）显示前 n 行，不能指定每行字数
private void RichTextBoxDisplayNLines(int lineNum)
{
richTextBox1.Lines = richTextBox1.Lines.Take(lineNum).ToArray();
}
调用（仅显示前 5 行）：
RichTextBoxDisplayNLines(5);
（2）显示前 n 行，能指定每行字数
using System.Text.RegularExpressions;
/// <summary>
/// 仅显示前 n 行且能指定每行字数
/// </summary>
/// <param name="text">文本</param>
/// <param name="lineNum">显示行数</param>
/// <param name="numEachLine">每行字数</param>
/// <param name="replaceLineBreak">是否取代文本中的换行符；如果取代，所有行变一行，然后再分行；如果不取代，把原来的每行分为多行</param>
/// <returns>每行指定字数的指定行数的文本</returns>
private string RichTextBoxDisplayNLines(string text, int lineNum, int numEachLine, bool replaceLineBreak = false)
{
if (string.IsNullOrEmpty(text) || lineNum <= 0 || numEachLine <= 0)
return null;
if (text.Length <= numEachLine)
return text;//当文本字数小于每行要求的字数时，返回原文本
string lineBreak = Environment.NewLine;
int realLen = 0;//文本以汉字为单位的长度
int lastLen = 0;//每行实际长度
if (replaceLineBreak)
{
text = Regex.Replace(text, "["[\\s]]{2,}", " ");//去掉空格
text = Regex.Replace(text, "("[\\s]*&[n|N][b|B][s|S][p|P];"[\\s]*)+", " ");//去掉
text = text.Trim().Replace("\n", "").Replace("\r", "");
realLen = GetTextRealLenght(ref text);
int n = realLen / numEachLine;
if (realLen % numEachLine > 0)
n++;
if (n > lineNum)
n = lineNum;
//把换行符插到每行指定字数后
for (int i = 0; i < n; i++)
{
lastLen += GetTextRealLenght(ref text, numEachLine * 2, lastLen);
if (i == 0)
{
if (i == n - 1)//只显示一行
text = text.Substring(0, lastLen);
else
text = text.Insert(lastLen, lineBreak);
lastLen += lineBreak.Length;
}
else
{
if (i != n - 1)//最后一行不插换行符
{
text = text.Insert(lastLen, lineBreak);
lastLen += lineBreak.Length;
}
else
{
//如果原文本长度大于指定行数，只显示指定行数
if (text.Length >= lastLen)
text = text.Substring(0, lastLen);
}
}
}
}
else
{
string[] arr = text.Split( Environment.NewLine.ToCharArray(), StringSplitOptions.RemoveEmptyEntries);
int currLineNum = 0;
text = string.Empty;
bool flag = false;//最后一次是否插入过换行符
for (int i = 0; i < arr.Length && currLineNum < lineNum; i++)
{
if (!string.IsNullOrEmpty(arr[i]))
{
realLen = GetTextRealLenght(ref arr[i]);
int n = realLen / numEachLine;
if (realLen % numEachLine > 0)
n++;
if (n == 0)
n = 1;
for (int j = 0; j < n && currLineNum < lineNum; j++)
{
lastLen += GetTextRealLenght(ref arr[i], numEachLine * 2, lastLen);
//只有原文本的每行字数大于指定的每行字数时才重新拆分为多行
if (realLen > numEachLine)
{
if (j == 0)
{
if (currLineNum == lineNum - 1)
{
arr[i] = arr[i].Substring(0, lastLen);//只显示一行
flag = true;
}
else
arr[i] = arr[i].Insert(lastLen, lineBreak);
lastLen += lineBreak.Length;
}
else
{
//每隔每行指定个字插入一个换行符
if (j != n - 1 && currLineNum != lineNum - 1)
{
arr[i] = arr[i].Insert(lastLen, lineBreak);
}
else
{
if (currLineNum == lineNum - 1 && lastLen < realLen + (j + 1) * lineBreak.Length)
{
arr[i] = arr[i].Insert(lastLen, lineBreak);
flag = true;
}
}
// 从原文本当前行截取到最后一行
if (currLineNum == lineNum - 1 && flag)
arr[i] = arr[i].Substring(0, arr[i].LastIndexOf(lineBreak));
lastLen += lineBreak.Length;
}
}
currLineNum++;
}
lastLen = 0;
text += arr[i];
if (currLineNum != lineNum)//不是最后一行，每段后加一个换行符
stext += lineBreak;
}
}
}
return text;
}
//统计以汉字为单位字符个数
private int GetTextRealLenght(ref string text)
{
int len = text.Length, cnNum = 0, enNum = 0;
GetTextRealLenght(ref text, text.Length * 2, 0, ref cnNum, ref enNum);
int enLen = enNum / 2;
if (enNum % 2 > 0)
enLen++;
return cnNum + enLen;
}
/// <summary>
/// 统计汉字和字母个数，一个汉字或字母都算一个
/// </summary>
/// <param name="text">文本</param>
/// <param name="num">指定字数</param>
/// <param name="i">开始统计位置</param>
/// <returns>满足条件的汉字和字母个数</returns>
private int GetTextRealLenght(ref string text, int num, int i)
{
int len = text.Length, cnNum = 0, enNum = 0;
return GetTextRealLenght(ref text, num, i, ref cnNum, ref enNum);
}
/// <summary>
/// 统计汉字和字母个数，一个汉字或字母都算一个
/// </summary>
/// <param name="text">文本</param>
/// <param name="num">指定字数</param>
/// <param name="i">开始统计位置</param>
/// <param name="cnNum">汉字个数</param>
/// <param name="enNum">字母个数</param>
/// <returns>满足条件的汉字和字母个数</returns>
private int GetTextRealLenght(ref string text, int num, int i, ref int cnNum, ref int enNum)
{
int len = text.Length;
for (; i < len && 2 * cnNum + enNum < num; i++)
{
if ((int)text[i] > 128)
cnNum++;
else
enNum++;
}
return cnNum + enNum;
}
调用：
//取代原文本中的换行符：
richTextBox1.Text = RichTextBoxDisplayNLines(richTextBox1.Text, 12, 42, true);
//不取代原文本中的换行符：
richTextBox1.Text = RichTextBoxDisplayNLines(richTextBox1.Text, 12, 42);
效果如图5所示：
图5
（五）C# Winform Richtextbox 删除行
1、清空 RichTextBox
richTextBox1.Clear();
2、删除任意指定行
/// <summary>
/// 删除任意指定行
/// </summary>
/// <param name="startLineNum">开始行号</param>
/// <param name="endLineNum">结束行号</param>
private void DelSpecialLines(int startLineNum, int endLineNum)
{
//获取指定行的第一行的第一个字符的索引
int start = richTextBox1.GetFirstCharIndexFromLine(startLineNum - 1);
//获取指定行的最后一行的第一个字符的索引
int end = richTextBox1.GetFirstCharIndexFromLine(endLineNum);
richTextBox1.Select(start, end - start);//选中指定行
richTextBox1.SelectedText = "";//设置选择行的内容为空
}
调用：
DelSpecialLines(1, 1);//删除第 1 行
DelSpecialLines(6, 6);//删除第 6 行
DelSpecialLines(2, 4);//删除第 2 至 4 行
3、删除最后一行
richTextBox1.Text = richTextBox1.Text.Remove(richTextBox1.Text.Length - 1);
四、C# Winform richtextbox 修改选择文字的字体或颜色
1、右键 richtextbox，在弹出的菜单中选择“属性”，打开“属性”窗口，选择“事件”选项卡，在 SelectionChanged 右边添加 richTextBox1_SelectionChanged，然后按回车，则 richtextbox 添加选择事件，如图6所示：
图6
2、然后添加如下代码：
private void richTextBox1_SelectionChanged(object sender, EventArgs e)
{
if (richTextBox1.SelectedText.Length > 0)
{
richTextBox1.SelectionFont = new Font("楷体", 14);
richTextBox1.SelectionColor = Color.Red;
}
}
五、C# Winform richtextbox 修改文字的颜色
1、把包含指定文字的行修改为指定颜色
假如要把包含 Label 的行修改为指定颜色（如“红色”），代码如下：
private void ChangeColorForSpecialText(string specialText, Color color)
{
if (string.IsNullOrEmpty(specialText))
return;
int pos = 0;
int lineNum;
List<int> lst = new List<int>();
do
{
if (pos != 0 && pos + specialText.Length < richTextBox1.Text.Length)
pos += specialText.Length;//跳过要查找文字继续找
//查找指定文本的位置
pos = richTextBox1.Find(specialText, pos, RichTextBoxFinds.None);
if (pos > 0)
{
//根据文本位置返回它所在的行号
lineNum = richTextBox1.GetLineFromCharIndex(pos);
lst.Add(lineNum);
}
if (pos + specialText.Length > richTextBox1.Text.Length - 1)
break;
}while (pos >= 0 && pos < richTextBox1.Text.Length);
for (int i = 0; i < lst.Count; i++)
{
SelectLine(lst[i]);
richTextBox1.SelectionColor = color;
}
}
//选中一行，lineNum 为行号
private void SelectLine(int lineNum)
{
if (lineNum < 0)
return;
//根据行号返回该行第一个字符的索引
int start = this.richTextBox1.GetFirstCharIndexFromLine(lineNum);
int end = this.richTextBox1.GetFirstCharIndexFromLine(++lineNum);
if (start == -1)
return;
else if (end == -1)//如果 end 超出文本长度，则用文本长度 - start
end = this.richTextBox1.TextLength - start;
else
end = end - start;
this.richTextBox1.Select(start, end);
}
调用：
ChangeColorForSpecialText("Label", Color.Red);
效果如图7所示：
图7
2、把指定文字修改为指定颜色
private void ChangeColorForSpecialWord(string specialWord, Color color)
{
if (string.IsNullOrEmpty(specialWord))
return;
int pos = 0;
do
{
if (pos != 0 && pos + specialWord.Length < richTextBox1.Text.Length)
pos += specialWord.Length;//跳过要查找词继续找
//查找指定词的位置
pos = richTextBox1.Find(specialWord, pos, RichTextBoxFinds.None);
if (pos > 0)
{
richTextBox1.Select(pos, specialWord.Length);
richTextBox1.SelectionColor = color;
}
if (pos + specialWord.Length > richTextBox1.Text.Length - 1)
break;
} while (pos >= 0 && pos < richTextBox1.Text.Length);
}
调用：
ChangeColorForSpecialWord("Panel", Color.Red);// Panel 用红色标示
效果如图8所示：
图8
ChangeColorForSpecialWord("所示：\r4", Color.Red);// 用红色标示跨行的词（跨行查找）
效果如图9所示：
图9
