🏆 作者简介，愚公搬代码 🏆《头衔》：华为云特约编辑，华为云云享专家，华为开发者专家，华为产品云测专家，CSDN博客专家，阿里云专家博主，腾讯云优秀博主，掘金优秀博主，51CTO博客专家等。 🏆《近期荣誉》：2022年CSDN博客之星TOP2，2022年华为云十佳博主等。
🏆《博客内容》：.NET、Java、Python、Go、Node、前端、IOS、Android、鸿蒙、Linux、物联网、网络安全、大数据、人工智能、U3D游戏、小程序等相关领域知识。
🏆🎉欢迎 👍点赞✍评论⭐收藏

🚀前言

Winform控件是Windows Forms中的用户界面元素，它们可以用于创建Windows应用程序的各种视觉和交互组件，例如按钮、标签、文本框、下拉列表框、复选框、单选框、进度条等。开发人员可以使用Winform控件来构建用户界面并响应用户的操作行为，从而创建功能强大的桌面应用程序。

🚀一、RichTextBox

RichTextBox控件是Windows Forms中的一个文本编辑控件，可以用于显示和编辑格式化的文本。它支持多种文本格式，包括RTF、HTML和纯文本等，并可以通过控制字体、颜色、大小和对齐方式等来自定义文本样式。下面是一些常见的操作：

设置文本样式

使用SelectionFont、SelectionColor和SelectionIndent等属性来设置选中文本的字体、颜色和缩进等样式。

插入图片

使用InsertImage方法来插入图片，可以选择本地文件或者通过对话框选择。

复制和粘贴

使用Copy、Cut和Paste等方法来实现复制、剪切和粘贴操作。

撤销和恢复

使用Undo和Redo方法来撤销和恢复操作。

导出文本

使用SaveFile方法来保存文本内容，可以选择文件格式。

搜索和替换

使用Find、FindNext和Replace等方法来实现搜索和替换操作。

RichTextBox控件还支持拖放、自动滚动、行号显示和自动完成等功能，是一个非常实用的文本编辑工具。

🔎1.属性介绍

🦋1.1 AcceptsTab和AutoWordSelection

RichTextBox控件的AcceptsTab属性和AutoWordSelection属性可以用来控制文本编辑时的行为，具体用法如下：

AcceptsTab属性

AcceptsTab属性是一个布尔类型的属性，用于控制是否允许在RichTextBox控件中使用Tab键来插入制表符。默认情况下，该属性为false，即在RichTextBox中按下Tab键时会把焦点转移到下一个控件，而不是插入制表符。

若要使用Tab键插入制表符，可以将AcceptsTab属性设置为true。例如，在RichTextBox的构造函数中添加如下代码：

public Form1()
{
    InitializeComponent();
    richTextBox1.AcceptsTab = true;   
}

这样，用户在RichTextBox中按下Tab键时会插入一个制表符。

AutoWordSelection属性

AutoWordSelection属性是一个布尔类型的属性，用于控制当用户双击一个单词时，是否自动选择该单词的全部内容。默认情况下，该属性为true，即双击一个单词会自动选择该单词的全部内容。

如果要禁用该功能，可以将AutoWordSelection属性设置为false。例如，在RichTextBox的构造函数中添加如下代码：

public Form1()
{
    InitializeComponent();
    richTextBox1.AutoWordSelection = false;   
}

这样，用户双击一个单词时，只会选择该单词本身，而不会自动选择其余内容。

🦋1.2 BulletIndent和DetectUrls

RichTextBox控件是Windows Forms中常用的控件之一，可以用于显示和编辑富文本内容。其中BulletIndent和DetectUrls属性是控件的两个常用属性，下面分别介绍它们的使用方法。

BulletIndent属性

BulletIndent属性是RichTextBox控件用于设置段落符号缩进的属性，也就是设置段落开头的符号（例如圆点）离左边界的距离。可以通过设置BulletIndent属性来控制段落符号的缩进值。

使用方式：

//设置BulletIndent属性的值为20
richTextBox1.BulletIndent = 20;

DetectUrls属性

DetectUrls属性是RichTextBox控件用于自动检测文本中的URL链接的属性，如果将该属性设置为true，那么当用户输入或粘贴一个文本内容时，其中包含的URL链接将会自动变为可点击的超链接。

使用方式：

//设置DetectUrls属性为true
richTextBox1.DetectUrls = true;

当为true时，比如设置text为“https://www.baidu.com/”，然后在文本中会发现文本变成了蓝色，然后，此时它已经变成了一个链接，如果我们注册linkclick事件如下：

private void richTextBox1_LinkClicked(object sender, LinkClickedEventArgs e)
{
    System.Diagnostics.Process.Start(e.LinkText);

}

需要注意的是，在设置该属性之前，需要将RichTextBox控件的ReadOnly属性设置为false，否则该属性无法生效。

🦋1.3 EnableAutoDragDrop

RichTextBox控件的EnableAutoDragDrop属性可以控制控件是否自动响应拖放操作。

若EnableAutoDragDrop属性设置为true（默认值为false），则控件会自动响应拖放操作，即当文本被拖动到RichTextBox控件上时，控件会自动接受拖放操作，并将拖放的文本插入到控件中。

若EnableAutoDragDrop属性设置为false，则需要在控件的DragEnter和DragDrop事件中手动编写拖放操作的代码。

以下是一个示例代码，演示如何使用EnableAutoDragDrop属性：

private void Form1_Load(object sender, EventArgs e)
{
    // 设置RichTextBox控件的EnableAutoDragDrop属性为true
    richTextBox1.EnableAutoDragDrop = true;
}

private void richTextBox1_DragEnter(object sender, DragEventArgs e)
{
    // 取消拖放操作的默认效果
    e.Effect = DragDropEffects.Copy;
}

private void richTextBox1_DragDrop(object sender, DragEventArgs e)
{
    // 将拖放的文本插入到RichTextBox控件中
    richTextBox1.SelectedText = e.Data.GetData(DataFormats.Text).ToString();
}

我们将RichTextBox控件的EnableAutoDragDrop属性设置为true，这样当我们将文本拖动到控件中时，控件会自动响应拖放操作。同时，我们还编写了控件的DragEnter和DragDrop事件的代码，以便在手动进行拖放操作时实现正确的效果。

🦋1.4 HideSelection

HideSelection属性是RichTextBox控件的一个属性，其默认值为true。当HideSelection属性的值为true时，RichTextBox控件在失去焦点后，选定文本的背景色会变为控件的背景色，看起来就像没有选定文本一样。而当HideSelection属性的值为false时，选定文本的背景色不会改变，仍然是选定文本的颜色。

在Winform中使用HideSelection属性可以使得用户在选中文本后，即使控件失去焦点，也可以看到文本的选中状态。同时，在某些情况下也可以提高用户的交互体验。

可以通过以下代码来设置RichTextBox控件的HideSelection属性：

richTextBox1.HideSelection = false; // 设置为 false 表示选中文本的背景色不会改变
richTextBox1.HideSelection = true; // 设置为 true 表示选中文本的背景色会改变为控件的背景色

🦋1.5 ImeMode

RichTextBox控件的ImeMode属性用于指定输入法编辑器（IME）的模式。它可以设置为以下值之一：

ImeMode.NoControl：禁用输入法编辑器的控制。
ImeMode.On：启用输入法编辑器。
ImeMode.Disable：禁用输入法编辑器。
ImeMode.Close：关闭输入法编辑器。
ImeMode.Alpha：输入法编码为英文字母。
ImeMode.AlphaFull：输入法编码为英文字母和符号。
ImeMode.Hangul：输入法编码为韩文字母。
ImeMode.Hanja：输入法编码为汉字。

在Winform中设置RichTextBox控件的ImeMode属性的方法如下：

在设计器中选择RichTextBox控件。
在属性窗口中选择ImeMode属性。
选择合适的输入法模式。

同时，可以在代码中使用以下方式设置RichTextBox控件的ImeMode属性：

// 禁用输入法编辑器的控制
richTextBox1.ImeMode = ImeMode.NoControl;

// 启用输入法编辑器
richTextBox1.ImeMode = ImeMode.On;

// 禁用输入法编辑器
richTextBox1.ImeMode = ImeMode.Disable;

// 关闭输入法编辑器
richTextBox1.ImeMode = ImeMode.Close;

// 输入法编码为英文字母
richTextBox1.ImeMode = ImeMode.Alpha;

// 输入法编码为英文字母和符号
richTextBox1.ImeMode = ImeMode.AlphaFull;

// 输入法编码为韩文字母
richTextBox1.ImeMode = ImeMode.Hangul;

// 输入法编码为汉字
richTextBox1.ImeMode = ImeMode.Hanja;

🦋1.6 Multiline和RightMargin

RichTextBox控件是一个用于显示和编辑文本的控件，在Winform中使用非常广泛。RichTextBox控件有很多属性可供使用，其中Multiline和RightMargin属性是两个常用属性。

Multiline属性：

Multiline属性表示RichTextBox控件是否支持多行文本输入。默认情况下，该属性的值为False，即RichTextBox控件只能输入单行文本，如下所示：

// 创建一个RichTextBox控件
RichTextBox richTextBox1 = new RichTextBox();

// 设置Multiline属性为True，表示支持多行文本输入
richTextBox1.Multiline = true;

RightMargin属性：

RightMargin属性表示RichTextBox控件的右侧边距（以像素为单位）。默认情况下，该属性的值为0，即RichTextBox控件的文本从左侧开始显示，直到控件的边界为止。我们可以设置该属性来调整文本显示位置，如下所示：

// 创建一个RichTextBox控件
RichTextBox richTextBox1 = new RichTextBox();

// 设置RightMargin属性为50像素，表示文本从左侧开始显示，并在右侧留出50像素的空白
richTextBox1.RightMargin = 50;

🦋1.7 ShortcutsEnabled

RichTextBox控件的ShortcutsEnabled属性用于启用或禁用控件的快捷键功能。当此属性设置为true时，用户可以使用快捷键来执行一些常见的文本编辑操作，如剪切、复制、粘贴等。当此属性设置为false时，快捷键将不再起作用，用户只能使用鼠标来执行这些操作。

在Winform中，您可以通过以下步骤来使用RichTextBox的ShortcutsEnabled属性：

在Visual Studio中打开您的Winform应用程序项目
选择您想要使用RichTextBox控件的窗口或用户界面
在工具箱中找到RichTextBox控件并将其拖放到您的窗口或用户界面中
在窗口或用户界面的代码文件中找到您创建的RichTextBox控件的名称并添加以下代码：

richTextBox1.ShortcutsEnabled = true; //启用快捷键功能

richTextBox1.ShortcutsEnabled = false; //禁用快捷键功能

这将启用或禁用RichTextBox控件的快捷键功能，具体取决于您所选择的属性值。

🦋1.8 ShowSelectionMargin

RichTextBox控件的ShowSelectionMargin属性用于控制是否显示选中文本的边距。设置为true时，选中文本周围会显示一个灰色的边框，以使其更加显眼。

可以通过以下代码设置ShowSelectionMargin属性：

richTextBox1.ShowSelectionMargin = true;

如果希望禁用该属性，可以将其设置为false：

richTextBox1.ShowSelectionMargin = false;

🦋1.9 ZoomFactor

RichTextBox控件的ZoomFactor属性用于控制文本的缩放比例。它会影响RichTextBox中所有文本的大小，包括字体、行间距等等。

可以通过代码设置ZoomFactor属性，例如：

richTextBox1.ZoomFactor = 1.5f; //设置缩放比例为1.5倍

此外，也可以通过控件属性窗口设置ZoomFactor属性。在属性窗口中找到ZoomFactor属性，将其值修改为需要的缩放比例即可。

需要注意的是，ZoomFactor属性只能在运行时设置，并且不能超出系统所支持的最大缩放比例。在Windows 10中，最大缩放比例为1000%。

🦋1.10 ScrollBars

RichTextBox控件的ScrollBars属性用于控制文本框中的滚动条显示方式。该属性有以下四个选项：

None：不显示滚动条。
Horizontal：显示水平滚动条。
Vertical：显示垂直滚动条。
Both：同时显示水平和垂直滚动条。

通过设置该属性，可以在需要时方便地启用或禁用滚动条，以及调整文本框的外观和行为。

在WinForm中，可以通过在属性窗口中选择RichTextBox控件，然后在属性列表中找到ScrollBars属性进行设置。也可以在代码中使用以下语句来设置：

richTextBox1.ScrollBars = RichTextBoxScrollBars.Vertical;  //设置垂直滚动条

🔎2.常用场景

文本编辑器：RichTextBox控件提供了丰富的文本编辑功能，包括基本的富文本编辑功能（加粗、倾斜、下划线、颜色等），以及插入图片、链接、表格等高级功能。
聊天窗口：RichTextBox控件可以用来显示聊天记录，其中可以实现文字的颜色不同、头像的显示、消息气泡的实现等效果。
日志记录：RichTextBox控件可以用来记录系统日志，其中可以实现日志级别的不同颜色显示、时间戳的显示等功能。
帮助文档：RichTextBox控件可以作为帮助文档的容器，其中可以实现文字的颜色不同、超链接跳转等功能。
富文本邮件：RichTextBox控件可以用来编辑富文本邮件，其中可以实现文字的颜色不同、图片的插入、超链接的添加等功能。

🔎3.具体案例

一个常见的案例是使用RichTextBox控件显示富文本格式的内容，例如显示HTML、RTF或XML格式的数据。以下是一个Winform中使用RichTextBox控件的例子：

设置控件属性

首先在Visual Studio的表单设计器中添加一个RichTextBox控件。然后通过属性窗口设置控件的一些属性，例如：

Dock属性设置为Fill，使得控件在窗体中占据所有可用空间。
Multiline属性设置为True，允许在控件中显示多行文本。
ReadOnly属性设置为True或False，控制是否允许用户编辑文本。
ScrollBars属性设置为Vertical或Both，控制是否显示滚动条。
Font属性设置控件中文本的字体。
ForeColor和BackColor属性设置控件文本的前景和背景颜色。

显示富文本格式的内容

接下来可以编写代码来显示富文本格式的内容。例如，可以在控件中显示一个RTF格式的文档：

richTextBox1.LoadFile("example.rtf", RichTextBoxStreamType.RichText);

上述代码会将名为example.rtf的文件加载到richTextBox1控件中。

编辑富文本格式内容

除了展示富文本格式的内容，RichTextBox控件还可以用来编辑富文本格式的内容。例如：

richTextBox1.SelectionFont = new Font("Arial", 12, FontStyle.Bold);
richTextBox1.SelectedText = "Hello, World!";

上述代码会将richTextBox1控件中文本的字体设置为Arial 12号粗体，然后将“Hello, World!”文本插入到文本框的当前插入点。

我正在参与2023腾讯技术创作特训营第三期有奖征文，组队打卡瓜分大奖！

(完)WPF和Winform控件绘图专题（二）

【愚公系列】2023年11月 Winform控件专题 RichTextBox控件详解

🚀前言