TRichView与ScaleRichView在Delphi和C++Builder中的实战经验

简介TRichView 21.6 与 ScaleRichView 8.0 是面向 Delphi/CBuilder 开发者的富文本编辑与排版控件套件已注册正式版并附带完整源代码。本次打包还集成 RichViewActions、SRVControls、Report Workshop、RvHtmlImport、RichViewXML 等周边库可满足富文本编辑、HTML 导入导出、XML 存储、报表生成及所见即所得打印缩放等深层次定制需求适合需要快速构建文档类应用的开发者直接集成或二次编译。资源共 2000 个文件其中 1095 个 cpp、414 个 hpp、370 个 h 构成主要源代码体系另有 70 个 txt 说明、46 个 xml 配置及 4 个 pdf 文档压缩包整体约 110.37MB便于对照源码学习控件底层机制。目前已有 274 人学习/下载对希望深入掌握 TRichView 系列控件原理、并借助已注册版本绕开授权限制的开发者来说是较为完整的学习与项目参考资材。 从TRichView 21.6和ScaleRichView 8正式版在Delphi与CBuilder环境下的落地经验切入把选型、安装、组件分工、编辑器搭建、性能排坑、授权管理这六件事一次讲透。这篇内容适合那些准备在原生Windows桌面项目里做富文本编辑、报告排版、所见即所得打印预览的团队参考尤其是还在Delphi 10.x/11.x时代维护老项目的朋友。1. 选型复盘为什么是TRichView而不是其他富文本方案先交代一下背景。我手里有一个维护了好几年的Delphi原生Windows项目功能是生成结构化检测报告客户要求能在程序里直接编辑富文本段落插入图片表格还得把编辑结果原样导出成PDF和打印。这类需求在B/S架构下很成熟但在受限内网环境里客户就只接受C/S客户端所以富文本编辑能力只能自己做。刚开始我图省事直接用了VCL自带的TRichEdit。做原型确实快但越往后越难受文档对象模型太弱想精确控制每个段落的编号、缩进、字距非常费劲缩放和打印预览能力基本等于零打到第二页排版就乱了图片只能整行嵌入想做图文混排得靠Windows的底层消息硬抠。撑到第三轮客户评审我被打印效果和编辑界面不一致这个问题逼到必须换方案。当时摆在面前的有几个候选TMS组件包里的RichEdit、第三方开源的RichView兼容层、以及TRichView。我最终选了TRichView ScaleRichView的组合理由有三个第一TRichView的文档模型非常规范段落、段落样式、字符样式、列表、表格、图片、超链接都有独立对象不是拿一个RTF流硬扛。这意味着我能以编程方式逐段控制报告模板而不是让用户在一个文本框里自由发挥然后祈祷格式不乱。第二ScaleRichView提供了真正的所见即所得缩放预览编辑界面缩到50%还是放到200%版式不塌打印分页看得很清楚。这一点对报告类软件是刚需客户看到的编辑内容就是最终打印内容。第三它同时支持Delphi和CBuilder我团队里有人用Delphi写界面有人用CBuilder写底层SDK封装一套控件两头吃不用维护两套UI方案。我不建议一开始就上全套组件而是先把TRichView这个基础包跑通等确认打印和缩放确实需要再做ScaleRichView的增量升级。控件虽好学习成本也客观存在直接上全套容易劝退。2. 安装踩坑记录从解压到编译通过的四道关标题里写了已注册正式版这里多说一句TRichView的安装包分试用版和正式版正式版会给你注册名和注册码也可能是一个授权文件。拿到安装包先别急着点Install建议把整个zip解压到一个独立目录比如D:\Components\TRichView21然后按下面几步走。2.1 版本匹配是第一道坎TRichView 21.6官方支持的IDE范围覆盖了Delphi 2009到Delphi 12、CBuilder对应的版本但不同版本的DCU和BPL编译产物不能混用。我第一次图省事只编译了Delphi 10.4的DCU结果切到Delphi 11.2打开项目直接报dcu version mismatch。后来学乖了每个IDE版本都单独建编译输出目录用包管理器按IDE逐个编译不要共享DCU目录。2.2 编译安装步骤以Delphi 11.2为例流程是这样的打开Source\Packages\Delphi11\RichView.dpk右键执行Compile编译基础包再打开RichViewDesign.dpk先Compile再Install安装到IDE的组件面板。CBuilder同理对应路径下打开RichViewCBuilder系列的CBP文件编译后到IDE里确认组件注册。编译过程中最容易被忽略的是搜索路径。我习惯把以下目录加到项目的Library Path里避免每个工程都去手动配置Source\RichViewSource\ScaleRichViewSource\RichViewActionsSource\RvTable2.3 常见错误与解决Cannot load package错多半是BPL文件和当前IDE版本不匹配把IDE里注册过的旧版本全部卸载重新编译安装。File not found: RVStyle.dcuLibrary Path没加全检查Source\RichView目录是否在搜索路径里。Win32/Win64平台DCU混用Debug版和Release版、32位和64位编译输出不要放在同一个目录否则偶尔会出现莫名其妙的访问冲突。2.4 两个额外建议安装完毕后在IDE里打开一个Demo工程比如Demos\SimpleTextEditor先跑通再写自己的界面。另外强烈建议把安装包里的Help文件CHM拷到本地TRichView的对象模型很庞大离线文档查起来比自己猜API名高效得多。3. 组件家族分工TRichView、RichViewEdit和ScaleRichView到底谁干什么这套控件最大的迷惑点在于组件特别多刚接触的人容易搞混。其实抓住三条线就清楚了显示控件、编辑控件、缩放打印控件。3.1 三条主线的组件职责组件职责常用场景TRichView富文本展示不可编辑报告预览、文档阅读、邮件内容展示RichViewEdit富文本编辑继承TRichView行为编辑器主体用户输入与格式调整ScaleRichView缩放显示与打印控制内嵌一个编辑控件所见即所得编辑、打印预览、分页控制RichViewActions标准编辑动作集合剪贴板、撤销重做、字体设置、对齐方式RVStyle统一管理字符样式和段落样式模板化排版、防止用户随意改字体TRichView和RichViewEdit的区别可以理解成只读浏览器和可编辑输入框的区别。ScaleRichView则是一个容器内部聚合了编辑控件、文档模型、分页器和自定义绘制层对外暴露的是缩放比例、分页边距这些高层属性。3.2 文档模型是关键写代码之前先理解TRichView的文档对象模型。一份文档由多个段落Paragraph组成每个段落包含若干行内元素Inline行内元素可以是文本、图片、表格、超链接。样式不直接挂在文本上而是通过字符样式索引StyleNo和段落样式索引ParaStyleNo映射到RVStyle对象里。这个设计带来的最大好处是报告模板可以用样式体系控制。我在项目里预定义了报告标题、章节标题、正文、表格题注等段落样式以及黑色正文、红色告警等字符样式。用户编辑时只能选这些预设样式不能随意更换字体字号输出到PDF时所有字体统一走嵌入规则排版自然就稳了。3.3 ScaleRichView的缩放逻辑ScaleRichView的缩放是由ScaleMode和Zoom两个属性协同控制的。ScaleMode设为smScaleModeMultiply时Zoom是1.0就表示100%0.5表示50%2.0表示200%。设为smScaleModeDPIX时Zoom表示每英寸的像素数这时通常是为了适配高DPI显示器。实际使用时我习惯把缩放控件的TrackBar最小设为50、最大设成200步进10绑定ScaleRichView的Zoom属性。初始化代码大致如下with ScaleRichView1 do begin ScaleMode : smScaleModeMultiply; Zoom : 1.0; BackgroundStyle : bssSolid; Background : clWhite; PageBorder : True; PageBorderColor : clSilver; end;这一组配置能让编辑区看起来就像一张白纸上的真实页面客户对这个展示效果很买账。4. 实战搭建一个带缩放预览的报告编辑器前面原理讲完了现在给一套可以直接复制回去改的最小实现。4.1 界面布局我采用左侧组件列表、中间编辑区、底部缩放条、右侧属性微调的布局。中间编辑区放一个ScaleRichView主导视觉左侧是一个TreeView点击节点动态加载对应报告模板底部放一个TrackBar控制缩放旁边用Label显示当前百分比。4.2 初始化和模板加载procedure TfrmMain.FormCreate(Sender: TObject); begin RVStyle1.Styles.Clear; RVStyle1.Styles.Add.Token : TitleStyle; RVStyle1.Styles.Add.Token : BodyStyle; ScaleRichView1.RichViewEdit.Style : RVStyle1; ScaleRichView1.RichViewEdit.AddText(示例报告标题, RVStyle1.Styles[0].StyleNo); ScaleRichView1.RichViewEdit.AddText(#13#10这是正文内容, RVStyle1.Styles[1].StyleNo); ScaleRichView1.Format; end;Format方法必须调用它负责重新计算排版。添加大量内容后不调用Format界面不会刷新看起来像是控件卡死了。4.3 图片插入TRichView插入图片有几种方式最简单的是从文件流插入procedure TfrmMain.InsertImage(const AFileName: string); begin ScaleRichView1.RichViewEdit.InsertPicture(AFileName, rvvaBaseline); ScaleRichView1.Format; end;rvvaBaseline表示图片底部对齐到文本基线。如果要图片居中浮动需要用InsertFloatingPicture配合文档属性设置水平相对位置。个人建议先跑通基线对齐模式浮动图片涉及文档流回排容易出图片飞出页面的问题。4.4 导出PDF和打印导出PDF我走的不是TRichView自带的导出器而是先输出为RTF或者EMF再做二次转换。最简单的做法是ScaleRichView1.RichViewEdit.SaveRTF(report.rtf, False);打印则直接用ScaleRichView的Print方法ScaleRichView1.Print(报告打印);正式打印前先调用ScaleRichView1.Preview方法在预览对话框里翻一翻页。这能提前发现表格被拆到两页、标题孤立在页尾这类排版问题。4.5 一个重要的经验编辑状态下不要在RichViewEdit的OnChange事件里直接调用Format。我在早期版本这么干过每敲一键就全文档重新排版超过30页的文档卡顿到无法忍受。正确做法是设置一个脏标记用TTimer延迟300毫秒做一次格式化或者只在鼠标释放、失去焦点时才Format。这个小改动对长文档体验影响巨大。5. 性能与兼容性排坑长文档、字体回退、打印分页控件装好了Demo跑通了真正虐人的是性能优化阶段。我实际处理过几类问题这里按排查链路拆开讲。5.1 长文档滚动卡顿现象是500页以上的报告草案滚动时明显掉帧CPU好几个核在来回跳。排查时我先用IDE自带的Profiler看热点发现时间主要花在DrawText和Format上。进一步定位是页面加了很多高分辨率图片每次重绘都触发位图缩放性能自然拉胯。处理办法有三步图片插入时先压缩到不超过显示宽度两倍的像素大图禁止原图直接入文档开启ScaleRichView的OptimizeDraw选项按需绘制可见区域关闭不需要的视觉特效比如不必要的反锯齿。ScaleRichView1.OptimizedDraw : True; ScaleRichView1.ViewerOptions : ScaleRichView1.ViewerOptions - [voAutoHideScrollBars];5.2 字体回退问题客户机器上没装宋体或某些特殊字体时控件会替换字体行宽计算就会漂移打印效果和预览不一致。这个问题的根源是Windows字体替换机制和TRichView的字体测量默认值不一致。我的做法是在文档初始化时遍历一遍字符样式检查Charset和FontName必要时替换为系统存在的字体并在部署包中附带使用频率极高的几款字体文件。控件本身允许为每个字符样式指定不同的字体名备选列表合理配置之后能覆盖绝大部分客户环境。5.3 打印分页和页边距的单位换算TRichView内部长度单位是像素但打印需要精确到毫米。页面尺寸设置时使用SetPageSize和SetPageMargins参数单位是像素需要根据当前的DPI把毫米转像素。我常用的转换函数function MMToPx(const AMM: Double; DPI: Integer): Integer; begin Result : Round(AMM / 25.4 * DPI); end;经验是打印之前将ScaleRichView的DPI设置为打印机实际DPI或者直接调用AssignPrintingDevice让控件自己从打印机驱动读取参数。不要假设屏幕DPI等于打印机DPI高DPI笔记本上预览和打印会差得很离谱。5.4 表格跨页断开默认情况下表格行在分页时可能被截断文字被切到两页。排查后发现需要在RVStyle里的表格属性设置允许行跨页并且在需要的时候开启表头行重复。这些属性不太显眼文档里藏在Table Options里我写进了项目代码注释避免下一个人接手时又踩一遍。6. 版本与授权管理的实际体会最后聊聊版本和授权。TRichView和ScaleRichView的正式版授权对项目最大的价值不只是一行注册码而是可重复构建和合规分发。我踩到过这样一件事团队另一台编译机器上装的是评估版结果产出的测试版每开三次就弹出一次试用提醒客户侧负责验收的工程师直接截图留了记录整改单发出来很被动。后来我把注册信息统一写进项目环境变量构建脚本启动时检查注册表里是否存在正式版LICENSE条目没有就中断编译。净效果就是谁也不能拿评估版往构建链路上塞。版本升级方面我现在的原则是小版本不追大版本观望。TRichView 20到21.x的升级官方提供的DCU包结构有变化升级前最好先在Demo工程上验证一遍确认现有代码里的API没有被标记为Deprecated。正式项目不要只看新功能列表要重点确认自己用到的老API是否继续保留。另外推荐把正式版安装包连同License信息放到内部私有仓库或网盘固定目录里文件名带版本号统一命名例如TRichView21.6_SRV8_Registered_2024.zip并且同步保留一份README.txt记录安装和激活步骤。团队里人来人走这东西断了传承接手的同学只能靠记忆逆推浪费的时间足够做一个小功能了。最后再分享一个小技巧TRichView官方Demo里有大量贴近真实业务的范例比如文字编辑器、表格编辑器、邮件客户端、发票模板。每接到新的富文本排版需求先去Demo里找有没有对应场景有的话直接拿Demo工程做二次开发基线比自己从空Form开始堆代码快很多。这个习惯让我好几次在排期紧张的情况下保住了交付节奏。本文还有配套的精品资源点击获取