码上快乐

相关内容   简体   繁体

C# RichTextBox的用法

本文转载自  查看原文  2019-10-11 10:21  3457    控件

RichTextBox是一种可用于显示、输入和操作格式文本，除了可以实现TextBox的所有功能，还能提供富文本的显示功能。 控件除具有TextBox 控件的所有功能外，还能设定文字颜色、字体和段落格式，支持字符串查找功能，支持rtf格式等功能。

下面就其的常用到的功能进行介绍。

一、显示滚动条

RichTextBox可设置Multiline属性来控制是否显示滚动套，true为是，false为否。，默认为true。（此项属性在TextBox亦可实现）

滚动条分为两种：水平(Horizontal)滚动条和垂直(Vertical)滚动条，通过RichTextBox的ScrollBars属性设置如何显示滚动条。（此项属性在TextBox亦可实现）

ScrollBars属性值：

1、Both：只有当文本超过RichTextBox的宽度或长度时，才显示水平滚动条或垂直滚动条，或两个滚动条都显示。

2、None：从不显示任何类型的滚动条。

3、Horizontal：只有当文本超过RichTextBox的宽度时，才显示水平滚动条。必须将WordWrap属性设置为false，才会出现这种情况。（下面将会给出解释）

4、Vertical：只有档文本超过RichTextBox的高度时，才显示垂直滚动条。

5、ForcedHorizontal：当WordWrap属性设置为false时，显示水平滚动条。在文本未超过RichTextBox的宽度时，该滚动条显示为浅灰色。

6、ForcedVertical：始终显示垂直滚动条。在文本未超过RichTextBox的长度时，该滚动条显示为浅灰色。

7、ForcedBoth：始终显示垂直滚动条。当WordWrap属性设置为false时，显示水平滚动条。在文本未超过RichTextBox的宽度或长度时，两个滚动条均显示为灰色。

 

 注：RichTextBox的WordWrap属性：用于指示多行文本框控件在必要时是否换行到下一行的开始。当属性为true时，不论ScrollBars属性值是什么，都不会显示水平滚动条。

下面通过几个截图加以描述其区别。（此项属性TextBox亦可实现）

（1）、当WordWrap为true，ScrollBars为Both时：

  

由此可见，WordWrap为true时，一旦文本超过RichTextBox的宽度时，就会自动换行到下一行，自然不需要用到水平滚动条，也就不显示出来了。

（2）、当WordWrap为false，ScrollBars为Both时：

  

由此可知，WordWrap为false时，即使文本超过RichTextBox的宽度，也不会自动换行到下一行，只有用户输入回车时才会换行，并且当文本超过RichTextBox的宽度后，才会显示水平滚动条。

代码实现过程：

1
2
3
4
5
6
7
private  void  Form1_Load( object  sender, EventArgs e)  //窗体的Load事件
{
 
　　　richTextBox1.Multiline =   true  ;      //将Multiline属性设置为true，实现显示多行
      richTextBox1.ScrollBars = RichTextBoxScrollBars.Vertical;　 //设置ScrollBars属性实现只显示垂直滚动
 
}

 

二、设置字体属性

 可通过RichTextBox的Font属性和ForeColor属性设置（Visual Studio2013社区版找不到SelectionFont和SelectionColor属性），也可通过代码实现，如文本字体设置为楷体，字体大小为12，字样是粗体，文本颜色为红色：

1
2
3
4
5
6
7
private  void  Form1_Load( object  sender, EventArgs e)  //窗体的Load事件
{
　　richTextBox1.Multiline =  true  ;   //将Multiline属性设为true，实现显示多行
　　richTextBox1.ScrollBars = RichTextBoxScrollBars.Vertical;   //设置ScrollBars属性实现只显示垂直滚动条
　　richTextBox1.SelectionFont =  new  Font ( "楷体" , 12, FontStyle.Bold);   //设置SelectionFont属性实现控件中的文本为楷体，大小为12，字样是粗体
　　richTextBox1.SelectionColor = System.Drawing.Color.Red;     //设置SelectionColor属性实现控件中的文本颜色为红色
}

将RichTextBox控件显示为超链接样式

将以“http://”开头的Web链接地址作为超链接文本时，运行时RichTextBox超链接文本会自动变成蓝色字体且有下划线。

此时点击超链接文本不会有任何响应，需要在RichTextBox的LinkClicked事件中编写代码实现。

 

1
2
3
4
5
6
7
8
9
10
11
private  void  Form1_Load( object  sender, EventArgs e)            //窗体的Load事件
{
　　richTextBox1.Multiline =  true  ;    //将Multiline属性设为true，实现显示多行
　　richTextBox1.ScrollBars = RichTextBoxScrollBars.Vertical;    //设置ScrollBars属性实现只显示垂直滚动条
　　richTextBox1.Text =  "http://www.baidu.com百度一下你就知道" ;   //设置Text属性
}
 
private  void  richTextBox1_LinkClicked( object  sender, EventArgs e)
{
　　System.Diagnostics.Process.Start(e.LinkText);                    //在控件LinkClicked事件中编写如下代码实现内容中的网址单击后可以访问网址
}

 

 

 

三、设置段落格式

可通过设置SelectionBullet属性将选定的段落设置为项目符号列表的格 式，也可以使用SelectionIndent属性和SelectionHangingIndent属性设置段落相对于控件的左右边缘进行缩进。下面用代 码将控件的SelectionBullet属性设置为true，使控件中的内容以项目符号列表的格式排列。

1
2
3
4
5
6
private  void  Form1_Load( object  sender, EventArgs e)
{
　　richTextBox1.Multiline =  true  ;   
     richTextBox1.ScrollBars = RichTextBoxScrollBars.Vertical ;
　　richTextBox1.SelectionBullet =  true  ;
}

以下为属性SelectionBullet设为false和true时的差异（前者为false后者为true）：

  

通过SelectionIndent属性设置一个整数，该整数表示控件的左边缘和文本的左边缘之间的距离（以像素为单位）。通过SelectionRightIndent属性设置一个整数，该整数表示控件的右边缘与文本的右边缘之间的距离（以像素为单位）。

以下通过代码实现SelectionIndent属性设置。

 

1
2
3
4
5
6
private  void  Form1_Load( object  sender, EventArgs e)
{
　　richTextBox1.Multiline =  true  ;
　　richTextBox1.ScrollBars = RichTextBoxScrollBars.Vertical ;
　　richTextBox1.SelectionIndent = 50 ;
}

 

差异如下组图：

  

SelectionRightIndent属性与SelectionIndent属性类似，可类比，当然也可以同时使用。

 

四、常用功能

1．RichTextBox控件的常用属性

1） SelectedText属性、SelectionLength属性、SelectionStart属性——与TextBox控件的属性功能相同。 
2） SelectionFont：获取或设置选中的文本或插入点的字体，例如： 
1
richTextBox1.SelectionFont=fontDialog1.Font;  //设置为字体对话框中选中的字体
3） SelectionColor：获取或设置选中的文本或插入点的文本颜色。
4） SelectionAlignment：获取或设置应用到当前选定内容或插入点的对齐方式。
5） Lines属性——字符串数组。记录输入到RichText控件中的所有文本，每按两次回车键之间的字符串是该数组的一个元素。 
6） Modifyed属性——记录用户是否已修改控件中的文本内容。若已修改，该属性值自动设置为true。 
7） HideSelection属性——设置当焦点离开该控件时，选定的文本是否保持突出显示。值为false时突出显示。 

2．RichTextBox控件的常用事件

1）SelectionChange事件——控件中选中的文本发生改变时，触发该事件。  
2）TextChanged事件——控件中的文本内容发生改变时，触发该事件。

3．RichTextBox控件的常用方法

1）Clear( )方法——清除RichText控件中用户输入的所有内容。  
2）Copy( )、Cut( )、Paste( )方法——实现RichText控件的剪贴板功能； 
3）SelectAll( )方法——选中控件中的所有文本。  4）Find( )方法——实现查找功能。 
5）SaveFile( )方法、LoadFile( )方法——保存文本和打开文件。 
6）Undo( )方法、Redo( )方法——撤销上一次编辑操作、重做上次撤销的编辑操作。   
说明：常与CanUndo属性和CanRedo属性配合使用。 
7）LoadFile()——加载文本文件（*.txt）或RTF文件（*.rtf）。  
8）SaveFile()——保存文本文件（*.txt）或RTF文件（*.rtf）。


 4. 将文件加载到RichTextBox 对象中  

使用LoadFile( )方法.
（1）一般格式 
RichTextBox对象名.LoadFile(文件名,文件类型);   
（2）说明 
RichTextBox 控件可以显示纯文本、Unicode 纯文本或 RTF 格式文件。若要显示这些文件，可调用 LoadFile 方法。例如，使用打开文件对话框选择一个文本文件并加载到richTextBox1控件中，代码如下：  

1
2
3
4
5
6
openFileDialog1.Filter= "文本文件(*.txt)|*.txt|所有文件(*.*)|*.*" ;
if (openFileDialog1.ShowDialog()==DialogResult.OK)
{    
      string  fName=openFileDialog1.FileName;
      richTextBox1.LoadFile(fName,RichTextBoxStreamType.PlainText  );
}

RichTextBoxStreamType.PlainText为加载的文件类型，其他可选的枚举值如下：

5. 保存RichTextBox 对象中的文件

用SaveFile( )方法
（1）一般格式 
RichTextBox对象名.SaveFile(文件名,文件类型);    
（2）使用说明 
同LoadSave( )方法。
1
2
3
4
//保存RTF格式文件
saveFileDialog1.Filter= "RTF文件(*.rtf)|*.rtf" ; saveFileDialog1.DefaultExt= "rtf" ;<br> //默认的文件扩展名
if (saveFileDialog1.ShowDialog()==DialogResult.OK)
richTextBox1.SaveFile(saveFileDialog1.FileName,RichTextBoxStreamType.RichText );   

6. 插入图片文件

可借助剪贴板实现.

1
2
3
4
Clipboard.Clear();    //清空剪贴板
Bitmap bmp =  new  Bitmap( @"d:\图片1.jpg" );   //创建Bitmap类对象
Clipboard.SetImage(bmp);   //将Bitmap类对象写入剪贴板
richTextBox1.Paste();    //将剪贴板中的对象粘贴到RichTextBox1

 

7. 其它补充内容

TextBox控件用到的所有属性、事件和方法，RichTextBox控件几乎都能支持，例如 MaxLength、MultiLine、ScrollBars、SelLength、SelStart 和 SelText。
注意：
TextBoxBase.Undo 方法不可用于 KeyPress 或 TextChanged 事件。
RichTextBox 控件没有TextBox控件一样具有64K字符容量的限制。 
RichTextBox 控件提供许多可对控件内任何文本部分应用格式设置的属性。若要更改文本的格式设置，必须首先选定此文本。只能为选定的文本分配字符和段落格式设置。对选定 的文本内容进行设置后，在选定内容后输入的所有文本也用相同的设置进行格式设置，直到更改设置或选定控件文档的不同部分为止。SelectionFont 属性使您得以将文本以粗体或斜体显示。还可以使用此属性更改文本的大小和字样。SelectionColor 属性使您得以更改文本的颜色。若要创建项目符号列表，可以使用 SelectionBullet 属性。还可以通过设置 SelectionIndent、SelectionRightIndent 和 SelectionHangingIndent 属性调整段落格式设置。

 

RichTextBox 控件提供具有打开和保存文件的功能的方法。
LoadFile 方法使您得以将现有的 RTF 或 ASCII 文本文件加载到控件中。还可以从已打开的数据流加载数据。SaveFile 使您得以将文件保存到 RTF 或 ASCII 文本中。与 LoadFile 方法相似，还可以使用 SaveFile 方法保存到开放式数据流。

 
Find 方法被重载，可以同时查找控件文本内的文本字符串以及特定字符。 
也可以将 RichTextBox 控件初始化为内存中存储的数据。例如，可以将 Rtf 属性初始化为包含要显示文本的字符串，包括确定如何设置该文本格式的 RTF 代码。 
可以使用 DetectUrls 属性适当地显示控件文本中的链接（如到网站的链接）。然后可以处理 LinkClicked 事件以执行与该链接关联的任务。 
SelectionProtected 属性使您得以保护控件内的文本不被用户操作。当控件中有受保护的文本时，可以处理 Protected 事件以确定用户何时曾试图修改受保护的文本，并提醒用户该文本是受保护的，或向用户提供标准方式供其操作受保护的文本。
 
 
 
例1
将 RTF 文件加载到控件中并搜索单词“Text”的第一个实例。然后代码更改选定文本的字体样式、字体大小和字体颜色并将更改保存到原始文件。
  部分文字属性的更改

 

public void CreateMyRichTextBox()
{
RichTextBox richTextBox1 = new RichTextBox();
richTextBox1.Dock = DockStyle.Fill;

richTextBox1.LoadFile("C:\\MyDocument.rtf");
richTextBox1.Find("Text", RichTextBoxFinds.MatchCase);

richTextBox1.SelectionFont = new Font("Verdana", 12, FontStyle.Bold);
richTextBox1.SelectionColor = Color.Red;

richTextBox1.SaveFile("C:\\MyDocument.rtf", RichTextBoxStreamType.RichText);

this.Controls.Add(richTextBox1);
}

部分文字属性的更改

例2

更加负载的多媒体类型的文字段落的录入。

复制代码 
Demo

using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Text;
using System.Windows.Forms;

namespace Win_Test
{
    public partial class RichTextBox_Test : Form
    {
        public RichTextBox_Test()
        {
            InitializeComponent();
        }

        Font oldFont;
        Font newFont;

        //richTextBox1 所选文字加粗
        private void button1_Click(object sender, EventArgs e)
        {

            oldFont = this.richTextBox1.SelectionFont;
            if (oldFont.Bold)
            { newFont = new Font(oldFont, oldFont.Style & ~FontStyle.Bold); }
            else
                newFont = new Font(oldFont, oldFont.Style | FontStyle.Bold);

            this.richTextBox1.SelectionFont = newFont;
            this.richTextBox1.Focus();

        }

        //richTextBox1 所选文字加下划线
        private void button2_Click(object sender, EventArgs e)
        {
            oldFont = this.richTextBox1.SelectionFont;
            if (oldFont.Underline)
            { newFont = new Font(oldFont, oldFont.Style & ~FontStyle.Underline); }
            else
                newFont = new Font(oldFont, oldFont.Style | FontStyle.Underline);
            this.richTextBox1.SelectionFont = newFont;
            this.richTextBox1.Focus();


        }

        //richTextBox1 所选文字为斜体
        private void button3_Click(object sender, EventArgs e)
        {
            oldFont = this.richTextBox1.SelectionFont;
            if (oldFont.Italic)
            { newFont = new Font(oldFont, oldFont.Style & ~FontStyle.Italic); }
            else

                newFont = new Font(oldFont, oldFont.Style | FontStyle.Italic);
            this.richTextBox1.SelectionFont = newFont;
            this.richTextBox1.Focus();
        }

        //richTextBox1 所选文字居中
        private void button4_Click(object sender, EventArgs e)
        {
            if (this.richTextBox1.SelectionAlignment == HorizontalAlignment.Center)
                this.richTextBox1.SelectionAlignment = HorizontalAlignment.Left;
            else
                this.richTextBox1.SelectionAlignment = HorizontalAlignment.Center;
            this.richTextBox1.Focus();
        }


        // 在文本框输入字体大小
        private void textBox1_KeyPress(object sender, KeyPressEventArgs e)
        {
            //remove all characters that are not numbers,backspace and enter
            if ((e.KeyChar < 48 || e.KeyChar > 57) && e.KeyChar != 8 && e.KeyChar != 13)
            { e.Handled = true; }
            else if (e.KeyChar == 13)
            {
                TextBox txt = (TextBox)sender;
                if (txt.Text.Length > 0)
                    ApplyTextSize(txt.Text);
                e.Handled = true;
                this.richTextBox1.Focus();
            }
        }

        //根据textBox1的值设置richTextBox1的字体
        private void ApplyTextSize(string textSize)
        {
            float newSize = Convert.ToSingle(textSize);
            FontFamily currentFontFamily;
            Font newFont;
            currentFontFamily = this.richTextBox1.SelectionFont.FontFamily;
            newFont = new Font(currentFontFamily, newSize);
            this.richTextBox1.SelectionFont = newFont;
        }

        //在textBox1控件验证时触发，设置richTextBox1的字体
        private void textBox1_Validating(object sender, CancelEventArgs e)
        {
            TextBox txt = (TextBox)sender;
            ApplyTextSize(txt.Text);
            this.richTextBox1.Focus();
        }

        //让浏览器打开超链接地址
        private void richTextBox1_LinkClicked(object sender, LinkClickedEventArgs e)
        {
            System.Diagnostics.Process.Start(e.LinkText);
        }

        //richTextBox1 加载 Test.rtf 文件
        private void button5_Click(object sender, EventArgs e)
        {
            try
            {
                richTextBox1.LoadFile("Test.rtf");
            }
            catch (System.IO.FileNotFoundException)
            {
                MessageBox.Show("No file to be load yet");
            }
        }

        //richTextBox1 保存到 Test.rtf 文件
        private void button6_Click(object sender, EventArgs e)
        {
            try
            {
                richTextBox1.SaveFile("Test.rtf");
            }
            catch (System.Exception err)
            {
                MessageBox.Show(err.Message);
            }
        }

    }
}
复制代码
 

Demo

using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Text;
using System.Windows.Forms;

namespace Win_Test
{
public partial class RichTextBox_Test : Form
{
public RichTextBox_Test()
{
InitializeComponent();
}

Font oldFont;
Font newFont;

//richTextBox1 所选文字加粗
private void button1_Click(object sender, EventArgs e)
{

oldFont = this.richTextBox1.SelectionFont;
if (oldFont.Bold)
{ newFont = new Font(oldFont, oldFont.Style & ~FontStyle.Bold); }
else
newFont = new Font(oldFont, oldFont.Style | FontStyle.Bold);

this.richTextBox1.SelectionFont = newFont;
this.richTextBox1.Focus();

}

//richTextBox1 所选文字加下划线
private void button2_Click(object sender, EventArgs e)
{
oldFont = this.richTextBox1.SelectionFont;
if (oldFont.Underline)
{ newFont = new Font(oldFont, oldFont.Style & ~FontStyle.Underline); }
else
newFont = new Font(oldFont, oldFont.Style | FontStyle.Underline);
this.richTextBox1.SelectionFont = newFont;
this.richTextBox1.Focus();


}

//richTextBox1 所选文字为斜体
private void button3_Click(object sender, EventArgs e)
{
oldFont = this.richTextBox1.SelectionFont;
if (oldFont.Italic)
{ newFont = new Font(oldFont, oldFont.Style & ~FontStyle.Italic); }
else

newFont = new Font(oldFont, oldFont.Style | FontStyle.Italic);
this.richTextBox1.SelectionFont = newFont;
this.richTextBox1.Focus();
}

//richTextBox1 所选文字居中
private void button4_Click(object sender, EventArgs e)
{
if (this.richTextBox1.SelectionAlignment == HorizontalAlignment.Center)
this.richTextBox1.SelectionAlignment = HorizontalAlignment.Left;
else
this.richTextBox1.SelectionAlignment = HorizontalAlignment.Center;
this.richTextBox1.Focus();
}


// 在文本框输入字体大小
private void textBox1_KeyPress(object sender, KeyPressEventArgs e)
{
//remove all characters that are not numbers,backspace and enter
if ((e.KeyChar < 48 || e.KeyChar > 57) && e.KeyChar != 8 && e.KeyChar != 13)
{ e.Handled = true; }
else if (e.KeyChar == 13)
{
TextBox txt = (TextBox)sender;
if (txt.Text.Length > 0)
ApplyTextSize(txt.Text);
e.Handled = true;
this.richTextBox1.Focus();
}
}

//根据textBox1的值设置richTextBox1的字体
private void ApplyTextSize(string textSize)
{
float newSize = Convert.ToSingle(textSize);
FontFamily currentFontFamily;
Font newFont;
currentFontFamily = this.richTextBox1.SelectionFont.FontFamily;
newFont = new Font(currentFontFamily, newSize);
this.richTextBox1.SelectionFont = newFont;
}

//在textBox1控件验证时触发，设置richTextBox1的字体
private void textBox1_Validating(object sender, CancelEventArgs e)
{
TextBox txt = (TextBox)sender;
ApplyTextSize(txt.Text);
this.richTextBox1.Focus();
}

//让浏览器打开超链接地址
private void richTextBox1_LinkClicked(object sender, LinkClickedEventArgs e)
{
System.Diagnostics.Process.Start(e.LinkText);
}

//richTextBox1 加载 Test.rtf 文件
private void button5_Click(object sender, EventArgs e)
{
try
{
richTextBox1.LoadFile("Test.rtf");
}
catch (System.IO.FileNotFoundException)
{
MessageBox.Show("No file to be load yet");
}
}

//richTextBox1 保存到 Test.rtf 文件
private void button6_Click(object sender, EventArgs e)
{
try
{
richTextBox1.SaveFile("Test.rtf");
}
catch (System.Exception err)
{
MessageBox.Show(err.Message);
}
}

}
}

富文本，多类型的编码

 
没有整理与归纳的知识，一文不值！高度概括与梳理的知识，才是自己真正的知识与技能。 永远不要让自己的自由、好奇、充满创造力的想法被现实的框架所束缚，让创造力自由成长吧！ 多花时间，关心他（她）人，正如别人所关心你的。理想的腾飞与实现，没有别人的支持与帮助，是万万不能的。


免责声明！

本站转载的文章为个人学习借鉴使用，本站对版权不负任何法律责任。如果侵犯了您的隐私权益，请联系本站邮箱yoyou2525@163.com删除。



猜您在找 C# RichTextBox 里处理表格 关于C#在RichTextBox中添加超链接 C# winForm RichTextBox 每行显示不同颜色 C# RichTextBox插入带颜色数据 C# RichTextBox设置行间距 C# 控件 RichTextBox 显示行号，并且与Panel相互联动 C# WinForm 为 RichTextBox 添加行号小技巧 C#里面怎样设置richTextBox的行间距 C#超简单方法实现两个richtextbox控件滚动条同步滚动 C# SendKeys用法
 
粤ICP备18138465号  © 2018-2024 CODEPRJ.COM