.Net中RichTextBox控件的详细用法

发表于:2020-8-19 10:50

字体: | 上一篇 | 下一篇 | 我要投稿

 作者:wenglabs    来源:博客园

#
Donet
分享:
  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的宽度后,才会显示水平滚动条。
  代码实现过程:
  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,字样是粗体,文本颜色为红色:
  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事件中编写代码实现。
  private void Form1_Load(object sender, EventArgs e) //窗体的Load事件
  {
    richTextBox1.Multiline = true ; //将Multiline属性设为true,实现显示多行
    richTextBox1.ScrollBars = RichTextBoxScrollBars.Vertical; //设置ScrollBars属性实现只显示垂直滚动条
    richTextBox1.Text = "http://www.lmwlove.com/.net学习网"; //设置Text属性
  }
   
  private void richTextBox1_LinkClicked(object sender, EventArgs e)
  {
    System.Diagnostics.Process.Start(e.LinkText);//在控件LinkClicked事件中编写如下代码实现内容中的网址单击后可以访问网址
  }
  三、设置段落格式
  可通过设置SelectionBullet属性将选定的段落设置为项目符号列表的格 式,也可以使用SelectionIndent属性和SelectionHangingIndent属性设置段落相对于控件的左右边缘进行缩进。下面用代 码将控件的SelectionBullet属性设置为true,使控件中的内容以项目符号列表的格式排列。
  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属性设置。
  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:获取或设置选中的文本或插入点的字体,例如: 
  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控件中,代码如下:
  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( )方法。
  //保存RTF格式文件
  saveFileDialog1.Filter="RTF文件(*.rtf)|*.rtf"; saveFileDialog1.DefaultExt="rtf";<br >//默认的文件扩展名
  if(saveFileDialog1.ShowDialog()==DialogResult.OK)
  richTextBox1.SaveFile(saveFileDialog1.FileName,RichTextBoxStreamType.RichText ); 
  6. 插入图片文件
  可借助剪贴板实现.
  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:更加负载的多媒体类型的文字段落的录入。
  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);
              }
          }
      }
  }

  本文内容不用于商业目的,如涉及知识产权问题,请权利人联系51Testing小编(021-64471599-8017),我们将立即处理
《2023软件测试行业现状调查报告》独家发布~

关注51Testing

联系我们

快捷面板 站点地图 联系我们 广告服务 关于我们 站长统计 发展历程

法律顾问:上海兰迪律师事务所 项棋律师
版权所有 上海博为峰软件技术股份有限公司 Copyright©51testing.com 2003-2024
投诉及意见反馈:webmaster@51testing.com; 业务联系:service@51testing.com 021-64471599-8017

沪ICP备05003035号

沪公网安备 31010102002173号