「干货分享」DevExpress常用控件——RichEditControl使用指南
做WinForms的一般都知道传统.NET界面有一个RichTextBox控件这个是一个富文本控件可以存储图片文字等内容它有自己的文件格式RTF在DevExpress控件组里面也有一个同等的控件他的名字是RichEditControl这个控件功能很强大它可以做邮件编辑器实现图文并茂的邮件的功能如下所示。本文主要介绍如何一步步使用这个控件实现自己需要的功能和界面。DevExpress WinForms能完美构建流畅、美观且易于使用的应用程序无论是Office风格的界面还是分析处理大批量的业务数据它都能轻松胜任DevExpress新旧版本帮助文档获取可点击这篇文章查看——《界面控件DevExpress v26.1帮助文档大全CHM版本》但是默认它没有任何工具栏全部是需要自己添加上去。如何创建带工具栏的RichEditControl控件为了使得控件更加通用我做了一个自定义控件用来实现通用文本编辑器的功能首先我们创建一个自定义控件如下所示。这样我们会看到一个空白的自定义控件界面然后再往里面添加一个RichEditControl进去设置DockFill,让RichEditControl控件铺满整个自定义控件界面如下所示。设置器ActiveViewTypeSimple让控件显示的更紧凑一些。如下所示。从上面我们看到它默认是没有任何工具栏的比较简单那么我们要添加向上面邮件界面的功能如何实现呢很简单选中RichEditControl,然后再右上角的三角符号上单击可以看到有一些功能菜单如下所示。单击Create BarManager然后可以进一步看到更多的工具栏菜单了如下所示。你可以悬着Create All Bar来创建所有工具栏然后删除多余的就可以了。这样就可以把所有的工具栏全部列出来了很多很多。但是一般我们不需要那么多精简一些重要的功能即可这些多余的最好删除否则很凌乱。这些功能按钮默认都已经带有事件的处理就是不需要额外的代码就可以实现各种标准的功能了这些很方便类似​​​​​​​DevExpress这方面做得很好如打印预览控件也是一样基本上不需要编写代码了选择需要的功能多余的删除即可这样就可以精简到我本文开头的那个邮件编辑器界面了。如何实现自定义的按钮功能刚才说到里面的按钮可以随意删除也可以随意组合到一个工具栏里面当然这个控件的工具栏除了内置的按钮外还可以增加自己的按钮和事件相应这样就更加完美和强大了。如上面的按钮就是我用来截图的一个功能自定义的内置的没有这样的功能这样添加按钮及图片后实现按钮的事件就可以了和自己创建的按钮一样。这个截图的功能利用了我的共用类库里面的一个截图类实现代码如下所示。ScreenCaptureWindow captureWindow null; private void barCapture_ItemClick(object sender, DevExpress.XtraBars.ItemClickEventArgs e) { if (this.ParentForm.Owner ! null) { this.ParentForm.Owner.Hide(); } this.ParentForm.Hide(); if (captureWindow ! null) { captureWindow.BitmapCropped - new EventHandler(captureWindow_BitmapCropped); captureWindow.Dispose(); captureWindow null; } if (captureWindow null) { captureWindow new ScreenCaptureWindow(); captureWindow.BitmapCropped new EventHandler(captureWindow_BitmapCropped); } captureWindow.Show(); captureWindow.TopMost true; captureWindow.TopMost false; } void captureWindow_BitmapCropped(object sender, EventArgs e) { try { if (captureWindow.DragStop ! captureWindow.DragStart) { RichEditControl control this.richEditControl1; control.Document.InsertImage(control.Document.CaretPosition, DocumentImageSource.FromImage(captureWindow.BitmapCache)); } } finally { if (this.ParentForm.Owner ! null) { this.ParentForm.Owner.Show(); } this.ParentForm.Show(); } }这个截图直接就是把Image插入到RichEditControl里面不需要另外存储图片到文件里的这就是RichEditControl控件方便之处如果我们要实现插入图片和加载文档的方法除了使用内置按钮推荐外其实自己也可以写事件来实现的如下代码就是实现这两个简单的功能一般不需要。private void barInsertImg_ItemClick(object sender, DevExpress.XtraBars.ItemClickEventArgs e) { string selectImage FileDialogHelper.OpenImage(true, ); if (!string.IsNullOrEmpty(selectImage)) { foreach (string file in selectImage.Split(new char[] { ,, ;, , })) { if (File.Exists(file)) { try { RichEditControl control this.richEditControl1; control.Document.InsertImage(control.Document.CaretPosition, DocumentImageSource.FromFile(file)); } catch { } } } } } private void barLoadFile_ItemClick(object sender, DevExpress.XtraBars.ItemClickEventArgs e) { string filter Word2003(*.doc)|*.doc|Word2007(*.docx)|*.docx|RTF(*.rtf)|*.rtf|HTM(*.htm)|*.htm|HTML(*.html)|*.html|All File(*.*)|*.*; string file FileDialogHelper.Open(打开文件, filter); if (!string.IsNullOrEmpty(file)) { //string htmlContent File.ReadAllText(file, Encoding.Default); //this.richEditControl1.HtmlText htmlContent; string path Path.GetFullPath(file); string extension Path.GetExtension(file); switch (extension.ToLower()) { case .htm: case .html: this.richEditControl1.Document.LoadDocument(file, DocumentFormat.Html, path); break; case .doc: this.richEditControl1.Document.LoadDocument(file, DocumentFormat.Doc, path); break; case .docx: this.richEditControl1.Document.LoadDocument(file, DocumentFormat.OpenXml, path); break; case .rtf: this.richEditControl1.Document.LoadDocument(file, DocumentFormat.Rtf, path); break; default: this.richEditControl1.Document.LoadDocument(file, DocumentFormat.PlainText, path); break; } //DocumentRange range richEditControl1.Document.Range; //CharacterProperties cp this.richEditControl1.Document.BeginUpdateCharacters(range); //cp.FontName 新宋体; //cp.FontSize 12; //this.richEditControl1.Document.EndUpdateCharacters(cp); } }RichEditControl的特殊操作1. 文档字体修正RichEditControl控件功能是强大不过一般也需要处理一些特殊的情况由于该控件加载的时候默认好像字体都是方正姚体的字体因此感觉很不好看那么我们就要在文档加载的时候把它的字体修改下操作如下所示修改为新宋体的字体比方正姚体的好看很多。public MyRichEdit() { InitializeComponent(); this.richEditControl1.DocumentLoaded new EventHandler(richEditControl1_DocumentLoaded); } 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代码如下所示。/// summary /// 把RichEditControl里面的内容导出为HTML和嵌入图片资源的辅助函数 /// /summary public class RichMailExporter : IUriProvider { int imageId; readonly RichEditControl control; ListLinkedAttachementInfo attachments; public RichMailExporter(RichEditControl control) { Guard.ArgumentNotNull(control, control); this.control control; } /// summary /// 导出内容和嵌入资源 /// /summary /// param namehtmlBodyHTML内容/param /// param nameattach附件资源/param public virtual void Export(out string htmlBody, out ListLinkedAttachementInfo attach) { this.attachments new ListLinkedAttachementInfo(); control.BeforeExport OnBeforeExport; htmlBody control.Document.GetHtmlText(control.Document.Range, this); control.BeforeExport - OnBeforeExport; attach this.attachments; } void OnBeforeExport(object sender, BeforeExportEventArgs e) { HtmlDocumentExporterOptions options e.Options as HtmlDocumentExporterOptions; if (options ! null) { options.Encoding Encoding.UTF8; } } #region IUriProvider Members public string CreateCssUri(string rootUri, string styleText, string relativeUri) { return String.Empty; } public string CreateImageUri(string rootUri, RichEditImage image, string relativeUri) { string imageName String.Format(image{0}, imageId); imageId; RichEditImageFormat imageFormat GetActualImageFormat(image.RawFormat); Stream stream new MemoryStream(image.GetImageBytes(imageFormat)); string mediaContentType RichEditImage.GetContentType(imageFormat); LinkedAttachementInfo info new LinkedAttachementInfo(stream, mediaContentType, imageName); attachments.Add(info); return cid: imageName; } private RichEditImageFormat GetActualImageFormat(RichEditImageFormat _RichEditImageFormat) { if (_RichEditImageFormat RichEditImageFormat.Exif || _RichEditImageFormat RichEditImageFormat.MemoryBmp) return RichEditImageFormat.Png; else return _RichEditImageFormat; } #endregion }/// summary /// 用来传递附件信息 /// /summary [Serializable] public class LinkedAttachementInfo { private Stream stream; private string mimeType; private string contentId; /// summary /// 参数构造函数 /// /summary /// param namestream附件流内容/param /// param namemimeType附件类型/param /// param namecontentId内容ID/param public LinkedAttachementInfo(Stream stream, string mimeType, string contentId) { this.stream stream; this.mimeType mimeType; this.contentId contentId; } /// summary /// 附件流内容 /// /summarypublic Stream Stream { get { return stream; } } /// summary /// 附件类型 /// /summarypublic string MimeType { get { return mimeType; } } /// summary /// 内容ID /// /summarypublic string ContentId { get { return contentId; } } }这样我们在获取编辑控件里面的HTML的同时也把里面的附件提取出来了方便我们发送邮件使用如下代码就是获取HTML内容和附件列表的其中LinkedAttachementInfo是以Stream和相关信息存在的一个实体类。string html ; ListLinkedAttachementInfo linkList new ListLinkedAttachementInfo(); RichMailExporter exporter new RichMailExporter(this.txtBody.richEditControl1); exporter.Export(out html, out linkList); MailInfo info new MailInfo(); info.Subject this.txtSubject.Text; info.Body html; info.IsBodyHtml true; info.EmbedObjects.AddRange(linkList);//添加嵌入资源 info.ToEmail this.txtRecipient.Text;//收件人这样我们发送邮件的时候写入附件数据就可以了如下代码所示。//嵌入资源的发送操作 AlternateView view AlternateView.CreateAlternateViewFromString(mailInfo.Body, Encoding.UTF8, MediaTypeNames.Text.Html); foreach (LinkedAttachementInfo link in mailInfo.EmbedObjects) { LinkedResource resource new LinkedResource(link.Stream, link.MimeType); resource.ContentId link.ContentId; view.LinkedResources.Add(resource); } mail.AlternateViews.Add(view);发送成功后我们就会看到图文并茂的邮件了。3. 内容支持搜索的操作邮件保存的时候我们可以把RichEditControl的内容作为RTF格式进行保存这样图片的资源就作为代码进行保存了这样恢复显示也很方便唯一不好的就是这些内容不好搜索建议如果要支持搜索可以通过增加另外一个文本字段把内容转换为纯文本进行保存这样加载就以RTF内容加载搜索的时候就搜索纯文本就可以了。以上就是我在使用​​​​​​​DevExpress的RichEditControl过程中碰到和解决问题的过程希望对大家有帮助共同提高。本文转载自博客园 - 伍华聪

相关新闻

基于MCP Server构建AI可查询的错误知识库:从协议到实践

基于MCP Server构建AI可查询的错误知识库:从协议到实践

把一段崩溃日志直接扔给大模型,它往往会回你一句“这可能是网络问题”——这个场景,很多开发者已经熟悉到麻木。原因倒也不难理解:大模型不是一个精确的检索系统,它对具体异常的理解来自训练数据里的概率分布,而不是你…

2026/11/21 18:48:12 阅读更多 →
DesktopAudio:macOS系统音频内录工具详解与实战

DesktopAudio:macOS系统音频内录工具详解与实战

这次我们来看一个 macOS 上的实用小工具:DesktopAudio。从名字就能看出来,它解决的是 Mac 用户长期以来的一个痛点——录制系统内部播放的声音。很多场景下我们需要把 Mac 正在播放的音频完整录下来,但 macOS 没有像 Windows 那样直接提供“立…

2026/11/15 0:13:48 阅读更多 →
「详解」看界面控件DevExtreme如何实现异步验证

「详解」看界面控件DevExtreme如何实现异步验证

DevExtreme拥有高性能的HTML5 / JavaScript小部件集合,使您可以利用现代Web开发堆栈(包括React,Angular,ASP.NET Core,jQuery,Knockout等)构建交互式的Web应用程序,该套件附带功能齐…

2026/11/17 15:26:50 阅读更多 →

最新新闻

Electron桌面应用开发实战:从环境搭建到打包发布全流程

Electron桌面应用开发实战:从环境搭建到打包发布全流程

做前端这些年,我大部分时间都在跟浏览器标签页打交道,直到第一次把桌面应用跑起来,才发现原来自己一直被限制在地址栏和刷新按钮围起来的框框里。Electron这个词,最开始是在某段时间频繁出现在同事的讨论里,一个用HTML…

2026/11/20 23:27:28 阅读更多 →
滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

简介:亚太天能T109滑盖智能锁产品说明书是一份PDF格式的官方技术文档,主要面向智能锁安装人员、终端用户及售后维护者,帮助快速掌握产品安装、配置与常见故障处理。全包仅1个PDF文件,大小4.37MB,内容结构清晰&#xff…

2026/11/20 23:27:28 阅读更多 →
PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

上个月我在调试一台高速AGV的驱动系统,整车要求空载跑到8m/s,电机转速已经拉到额定点,驱动器的输出电压也顶到了母线电压极限附近。再往上踩速度指令,转速纹丝不动,三相电流反而开始震荡。那会儿我的第一反应就是&…

2026/11/20 23:27:28 阅读更多 →
C++核心知识点:从内存管理到STL的实战指南

C++核心知识点:从内存管理到STL的实战指南

C 这门语言我前前后后折腾了十几年,用它写过嵌入式驱动、做过游戏服务端,也搭过基础组件库。每次看到新人一头扎进"C 核心知识点"这个搜索词,我其实挺感慨的——这门语言的难点从来不是语法多,而是知识点之间的耦合太深…

2026/11/20 21:55:32 阅读更多 →
T109滑盖智能锁怎么装?安装调试与故障排查全攻略

T109滑盖智能锁怎么装?安装调试与故障排查全攻略

简介:亚太天能T109滑盖智能锁产品说明书以PDF格式发布,适合智能锁用户、安装人员与售后维修人员阅读。内容围绕T109系列指纹密码刷卡锁展开,先介绍前面板、后面板、锁体、机械钥匙、电池盒盖等部件名称与功能,再给出完整安装步骤&…

2026/11/20 23:27:28 阅读更多 →
LLM知识降熵:从信息垄断到理解权下放

LLM知识降熵:从信息垄断到理解权下放

你有没有过这种经历:翻开源码注释、论文摘要或者一份专业报告,每个字都认识,连在一起却像天书。想找人聊聊,身边要么没人懂,要么懂的懒得跟你解释。后来我试着把同一段内容丢给一个大语言模型,几秒钟之后&a…

2026/11/20 22:59:12 阅读更多 →

日新闻

周新闻

月新闻