DevExpress_常用控件22_RichEditControl

4、Rich Text Editor

1、RichEditControl控件

该控件可以生成类似Word文档的文本编辑器，

虽然RichTextBox还是不够完美，排版的效果比word差太远，

但好在与word的兼容性不错，所以通常可在word里排版，然后复制到 RichTextBox里

另外, 可以通过CreateBarManger方法自动生成相应的菜单项；

---

传统.NET界面也有一个RichTextBox控件，一个富文本控件，可存储图片文字，有自己的文件格式RTF，

在DevExpress控件组里面也有一个同等的控件，RichEditControl，

但是默认它没有任何工具栏，全部是需要自己添加上去。

下面我们一步步使用这个控件实现自己需要的功能和界面。

期望最终效果如下:

---

1、如何创建带工具栏的RichEditControl控件

为了使得控件更加通用，我做了一个自定义控件，用来实现通用文本编辑器的功能，

首先我们创建一个自定义控件，

User Control 如下所示:

---

这样我们会看到一个一尘不染的自定义控件界面，

然后再往里面添加一个RichEditControl进去，

设置Dock = Fill,让RichEditControl控件铺满整个自定义控件界面，

设置器ActiveViewType = Simple(其他两个是Draft, PrintLayout) 让控件显示的更紧凑一些。

如下所示。

---

从上面我们看到，它默认是没有任何工具栏的，

选中RichEditControl, 然后再右上角的三角符号上，单击可以看到有一些功能菜单，

如下所示。

---

单击Create BarManager, 然后可以进一步看到更多的工具栏菜单了。

可以先选择Create All Bar来创建所有工具栏，然后隐藏多余的就可以了(属性面板Visible设置为false)。

---

如下所示:

---

这样就可以把所有的工具栏全部列出来了。

---

一般不需要那么多，隐藏掉多余的(如何隐藏???属性面板中Visible为false)

这样就可以精简到本文开头的邮件编辑器界面了。

---

2、如何实现自定义的按钮功能

按钮可以随意隐藏，也可以随意组合到一个工具栏里面，

当然，这个控件的工具栏还可以增加自己的按钮和处理事件喔~

如上面的按钮，就是用来截图的一个功能，这个是自定义的，内置的没有这样的功能哟，

这样添加按钮及图片后，实现按钮的事件就可以了，和自己创建的按钮一样。

这个截图功能，实现代码如下所示。

// full screen capture
		int i = 0;
		int w = Screen.PrimaryScreen.Bounds.Width;
		int h = Screen.PrimaryScreen.Bounds.Height;
	
		private void barButtonItem1_ItemClick(object sender, DevExpress.XtraBars.ItemClickEventArgs e)
		{
			WindowState = FormWindowState.Minimized;
			Thread.Sleep(300);
			i += 1;
			Bitmap b = new Bitmap(w,h);
			Graphics graphics = Graphics.FromImage(b);
			graphics.CopyFromScreen(0, 0, 0, 0, new Size(w, h));
			b.Save("C:\\gtzb\\" + i + ".jpg");
			WindowState = FormWindowState.Normal;
			Clipboard.SetImage(b);
			Cursor = Cursors.Default;
		}

 

---

截图代码2:

可对图片进行区域裁剪

using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Text;
using System.Linq;
using System.Threading.Tasks;
using System.Windows.Forms;
using DevExpress.XtraEditors;

namespace DXApplication_1
{
	public partial class ScreenCaptureForm : DevExpress.XtraEditors.XtraForm
	{
		public ScreenCaptureForm()
		{
			InitializeComponent();
		}

		// screen capture 2
		int i = 0;
		Bitmap originBitmap;
		Bitmap copyOfOriginBitmap;

		Bitmap croppedBit;
		int startX;
		int startY;
		int endX;
		int endY;

		Pen pen = new Pen(Color.Red, 2);
		Rectangle croppedRectangle = new Rectangle();

		Graphics croppedGraphics;

		private void ScreenCaptureForm_Load(object sender, EventArgs e)
		{
			i++;
			WindowState = FormWindowState.Minimized;
			FormBorderStyle = FormBorderStyle.None;
			Cursor = Cursors.Cross;

			int w = Screen.PrimaryScreen.Bounds.Width;
			int h = Screen.PrimaryScreen.Bounds.Height;	
			originBitmap = new Bitmap(w,h);

			Graphics tmpGraphic = Graphics.FromImage(originBitmap);
			tmpGraphic.CopyFromScreen(0, 0, 0, 0, new Size(w, h));

			pictureBox1.Image = originBitmap;
			originBitmap.Save("C:\\gtzb\\" + i + ".jpg");
			WindowState = FormWindowState.Maximized;
		}

		private void pictureBox1_Click(object sender, EventArgs e)
		{
		}

		private void pictureBox1_MouseClick(object sender, MouseEventArgs e)
		{
			if(e.Button == MouseButtons.Right)
			{
				this.Close();
			}
		}

		private void pictureBox1_MouseDown(object sender, MouseEventArgs e)
		{
			if (e.Button == MouseButtons.Left)
			{
				startX = Math.Abs(e.X);
				startY = Math.Abs(e.Y);
			}
		}

		private void pictureBox1_MouseMove(object sender, MouseEventArgs e)
		{
			if(e.Button == MouseButtons.Left)
			{
				endX = Math.Abs(e.X);
				endY = Math.Abs(e.Y);
				Graphics tmpGraphics = pictureBox1.CreateGraphics();
				croppedRectangle = new Rectangle(startX, startY, endX - startX, endY - startY);
				Refresh();
				tmpGraphics.DrawRectangle(pen, croppedRectangle);
			}
		}

		private void pictureBox1_MouseUp(object sender, MouseEventArgs e)
		{
			copyOfOriginBitmap = (Bitmap)originBitmap.Clone();

			croppedBit = new Bitmap(croppedRectangle.Width, croppedRectangle.Height);
			croppedGraphics = Graphics.FromImage(croppedBit);
			croppedGraphics.DrawImage(copyOfOriginBitmap, new Rectangle(0, 0, croppedRectangle.Width, croppedRectangle.Height), croppedRectangle, GraphicsUnit.Pixel);

			pictureBox1.Image = croppedBit;
			croppedBit.Save("C:\\gtzb\\" + i + ".jpg");
			Clipboard.SetImage(croppedBit);
		}
	}
}

---

效果如下:

 

---

打开保存截图目录:

// reveal in finder
private void button3_Click(object sender, EventArgs e)
        {
            System.Diagnostics.Process.Start("C:\\Users\\beyond\\source\\repos\\DXApplication_1");
            TopMost = false;
            this.Cursor = Cursors.Default;
        }

---

这个截图，可以直接把Image插入到RichEditControl里面，

而不需要另外存储图片到文件里，这也是RichEditControl控件方便之处，

如果要实现插入图片和加载文档的方法，

除了使用内置按钮（推荐）外，其实自己也可以写事件来实现的，

---

如下代码就是实现插入图片和加载文档这两个简单的功能（一般用不上,看看就好）。

插入图片代码如下:

string imagePath = "C:\\Users\\beyond\\source\\repos\\DXApplication_1\\menma_13.png";
			
this.richEditControl1.Document.InsertImage(this.richEditControl1.Document.CaretPosition, DocumentImageSource.FromFile(imagePath));

---

加载文档代码如下:

private void r_ItemClick(object sender, DevExpress.XtraBars.ItemClickEventArgs e)
		{
			OpenFileDialog openFileDialog = new OpenFileDialog();
			openFileDialog.Title = "load file";
			openFileDialog.Filter = "Word2003(*.doc)|*.doc|Word2007(*.docx)|*.docx|RTF(*.rtf)|*.rtf|HTM(*.htm)|*.htm|HTML(*.html)|*.html|All File(*.*)|*.*";
			openFileDialog.RestoreDirectory = false;
			if (openFileDialog.ShowDialog() == DialogResult.OK) {
				string filePath = System.IO.Path.GetFullPath(openFileDialog.FileName);
				string ext = Path.GetExtension(filePath);
				if(ext.EndsWith("htm") | ext.EndsWith("html"))
				{
					richEditControl1.Document.LoadDocument(openFileDialog.FileName, DocumentFormat.Html, filePath);
					return;
				}
				if (ext.EndsWith("doc"))
				{
					richEditControl1.Document.LoadDocument(openFileDialog.FileName, DocumentFormat.Doc, filePath);
					return;
				}
				if (ext.EndsWith("docx") )
				{
					richEditControl1.Document.LoadDocument(openFileDialog.FileName, DocumentFormat.OpenXml, filePath);
					return;
				}
				if (ext.EndsWith("rtf"))
				{
					richEditControl1.Document.LoadDocument(openFileDialog.FileName, DocumentFormat.Rtf, filePath);
					return;
				}
				richEditControl1.Document.LoadDocument(openFileDialog.FileName, DocumentFormat.PlainText, filePath);
			}
		}

 

注意: 

如果使用switch & case & default, 则会出现错误:

控件无法从最终用例标签("default")脱离开关

---

3、RichEditControl的特殊操作

1）文档字体修正

RichEditControl控件功能是强大，不过一般也需要处理一些特殊的情况，

由于该控件加载的时候，默认字体是方正姚体，感觉不好看，

 

那么我们就要在文档加载的时候，把它的字体修改下，

操作如下所示，修改为新宋体。

        // constructor
        public MyRichEdit()
        {
            InitializeComponent();

            this.richEditControl1.DocumentLoaded += new EventHandler(richEditControl1_DocumentLoaded);
        }

        // document onload
        void richEditControl1_DocumentLoaded(object sender, EventArgs e)
        {
            DocumentRange range = richEditControl1.Document.Range;
            CharacterProperties cp = this.richEditControl1.Document.BeginUpdateCharacters(range);
            cp.FontName = "新宋体";
            //cp.FontSize = 12;
            this.richEditControl1.Document.EndUpdateCharacters(cp);
        }

---

效果如下:

---

2）RichEditControl内置图片资源的解析

RichEditControl控件支持把图片作为内嵌资源存储在里面，

如果要把它作为邮件发送，

众所周知, 邮件内容虽然是HTML，

但图片资源需要独立取出来放到LinkedResource对象,

发送才能显示，否则不能显示图片。

 

而RichEditControl默认转换出来的HTML内容，是把图片作为Base64码写到文档里面，文档比较大的。

为了实现把图片独立提取出来，需要自定义一个该控件的解析类RichMailExporter，

代码如下所示。

(Sorry 实在编不下去了...)