简介面向 Delphi 与 CBuilder 开发者的 TRichView 21.6 与 ScaleRichView 8.0 正式版组件包已注册并附带完整源代码适合需要集成富文本编辑、排版、缩放显示与打印功能的桌面应用开发者。除核心组件外还包含 RichViewActions、SRVControls、Report Workshop、RvHtmlImport、RichViewXML 等多个扩展模块可用于构建从文档编辑到 HTML/XML 导入导出、报表生成的完整工具链。资源包共 2000 个文件压缩后 110.37MB以 1095 个 cpp、414 个 hpp、370 个 h 源代码文件为主体配合 xml 配置、txt 说明、pdf 文档和 htm 帮助文件便于本地查阅接口与定制修改。相比试用水印版这套已注册正式版省去激活限制可直接用于商业项目开发。目前已有 274 人学习/下载对于需要底层定制文档编辑能力的高级开发者有一定参考价值。1. 这套控件到底解决什么问题写过富文本编辑器的同行应该都有体会Delphi 自带的 TRichEdit 做简单文本还可以一旦要处理表格嵌套、图片混排、页眉页脚、所见即所得的缩放编辑就会开始各种别扭。TRichView21.6 配合 ScaleRichView8 这套已注册正式版解决的就是从「能显示 RTF」到「能做出 Word 级编辑体验」这一步跨度。它不是一个单控件而是整套文档处理方案TRichView 负责富文本的存储、渲染和编辑ScaleRichView 在其上做缩放打印布局适合做报表设计器、合同编辑器、OA 公文系统、富文本笔记这类场景。标题里带「已注册正式版」意味着拿到的是完整功能授权没有评估版的水印弹窗和功能裁剪直接可以进生产项目。这套组合在 Delphi 和 CBuilder 下都能用如果你是被产品经理要求「加个像 Word 一样的编辑器」逼到墙角或者要在现有管理系统里嵌入一套可靠的文档编辑打印能力这篇文章的实操路径可以直接照搬。接下来我会按选型理由、安装配置、最小工程、参数调整和踩坑记录的顺序拆开讲全部用我实际配置过的方案来写命令和代码就是可以直接动手的版本。2. 为什么是 TRichView 而不是原生控件架构与选型逻辑2.1 和原生 RichEdit 的差距在哪里很多团队第一反应是用 Windows 自带的 RichEdit 封装或者干脆自己用 GDI 画排版。前者的问题在于它受限于 Windows 的 RichEdit 版本对段落样式、表格、浮动图片的支持不稳定打印预览和窗体缩放的表现尤其难控。后者的问题更明显——排版引擎看着简单真正做到段落回流、分页计算、混合缩进的时候工作量是失控的。我常做的对比是拿一张带表格、图片、不同字号标题的测试文档在 TRichEdit 和 TRichView 里分别打开再保存。TRichEdit 处理复杂样式时很容易丢格式尤其遇到段落间距和图片环绕组合的情况而 TRichView 内部使用自己的 RVF 格式存储对样式信息的保留粒度细得多读取和写入的还原度稳定。这个差异在文档草稿箱、审批留痕这类功能里非常关键用户可不想打开历史记录发现样式全乱了。TRichView 的组件结构上也更适合工程化文档对象TRichView、编辑接口TRichViewEdit和显示控件解耦你能把同一份文档塞到不同界面里而不用复制数据。对于想把文档引擎嵌入到已有业务系统的团队这套结构比原生控件好做封装。对比项原生 RichEditTRichView ScaleRichView复杂样式还原弱跨版本格式丢失多强RVF 格式保留完整缩放编辑与打印预览需要自己写ScaleRichView 内置 WYSIWYG 缩放布局表格和嵌套支持一般API 别扭结构化好支持嵌套和合并跨平台成本Windows 绑定可控逻辑层与界面层分离授权系统自带已注册正式版无功能限制2.2 两个控件的分工TRichView 与 ScaleRichView 各管什么不要把这两个控件当成同一个东西的重复版本。TRichView 是核心引擎负责文档内容的读入、编辑操作、样式管理和序列化。它是无界面的逻辑组件也可以在窗体上单独当作编辑控件用但它的重点是内容模型。ScaleRichView 是在 TRichView 之上的显示与排版外壳它接管了缩放比例、页面尺寸、页眉页脚、分页坐标、打印输出这些「纸面表现层」的东西。我一般会在 Form 上同时放这两个控件TRichView 作为编辑器界面呈现给用户ScaleRichView 用来处理打印预览和按比例缩放。数据结构上两者共享同一个文档对象所以改一处另一处实时联动不需要做文档同步。开发者真正要花时间理解的是 TRichView 的文档模型段落、样式表、内联图片的层级关系而 ScaleRichView 的配置相对集中在几个布局属性和打印设置上。这个分工决定了接入思路业务数据统一写入 TRichView 文档所有涉及「最终展现给用户看」的操作从 ScaleRichView 走。如果一开始没有明确的职责区分很容易把代码写乱改样式的时候两边不同步排错会很痛苦。2.3 版本选择21.6 和 8 对应什么环境标题里的 21.6 指的是 TRichView 的主版本号ScaleRichView 8 是配套的缩放编辑组件版本。实际安装时官方提供的安装包通常会同时覆盖多个 Delphi 版本需要按你本机的编译器选对应的编译脚本。以我常用的配置来说Delphi 11 及以上版本可以直接用包管理器安装路径下的现成工程而老版本 Delphi 则需要走源码包重新编译这一点后续章节会展开。选这套组合而非单独用 TRichView 的原因很简单如果你只需要做个笔记编辑单控件就够用但一旦涉及打印布局、缩放预览、按页面导出 PDFScaleRichView 能帮你省掉大量底层的坐标换算工作。版本匹配上21.6 属于当前较新的迭代对高分屏 DPI 感知和 Unicode 处理已经做得比较完整值得直接采用。正式版的注册文件在安装后放入指定目录即可激活不需要额外的运行时序列号。3. 安装与激活已注册正式版的正确落地姿势3.1 安装包的编译顺序这套控件不是装机即用型的需要先确认你的开发环境再决定安装方式。拿到已注册正式版之后一般会得到一个安装包和一份 license 文件后缀可能是 .txt 或 .reg 风格的内容。第一次安装我建议先解压到独立目录不要直接放 Delphi 的默认库目录里避免版本冲突不好回滚。安装核心流程是先编译运行时包再编译设计期包。常见的做法是打开安装目录下对应你 Delphi 版本的分组文件夹比如Delphi_11里面会有多个.dpk工程文件。编译顺序不能乱先 build 运行期包不带 designtime 标识的再 build 设计期包否则启动 IDE 会报找不到已安装组件。以 TRichView 为例编译顺序大致是控制包 - 显示包 - ScaleRichView 包。如果某个包编译不通过优先检查路径是否含中文或空格Delphi 的包编译器对这两类情况非常敏感。我在这上面踩过一次项目路径带了中文名结果一连串包都编不过改纯英文路径后问题消失。cd /d D:\Libs\TRichView\Delphi_11 # 先清理旧编译产物避免残留 dc39 等缓存文件 dcc32 -B rv.dpk dcc32 -B rv_design.dpk # 随后切换到 ScaleRichView 目录继续 cd ..\ScaleRichView\Delphi_11 dcc32 -B srv.dpk dcc32 -B srv_design.dpk逻辑说明-B参数是重建rebuild确保所有包单元强制重新编译避免 IDE 使用过期的 DCU。这里只是演示最基础的命令行编译路径实际用 IDE 的 Project Manager 操作同理。参数说明dcc32对应 32 位 Windows 编译如果你用的是 64 位或跨平台目标需要换成对应工具链不过桌面 Windows 场景最省事的就是这一条。3.2 在 IDE 中安装设计期组件编译完成后通过 IDE 的 Component Install Packages 将设计期包加入。成功之后工具栏会出现一批新组件分类通常在 RichView 或 ScaleRichView 下。如果你只是把 dcu 路径加入了 Library 路径而没有安装设计期包那么代码里能引用 TRichView 类但窗体上拖不出来这是新手经常困惑的地方。已注册正式版的激活方式也在这个环节体现安装包目录里通常会有一个License或Reg文件夹把对应的许可证内容放到安装根目录即可。以我手上的版本来说控件启动时会自动探测当前工作目录和注册表两处授权信息如果编译出来的程序在未注册机器上运行可能会间歇性弹出授权确认正式版则无此行为。安装完毕后在 IDE 里重新打开已有工程Delphi 会提示组件版本兼容性问题。这时要确认所有引用路径都指向你新安装的库目录而不是旧版本目录。常见现象是编译报File not found: TRVItem.pas这类报错十有八九是 Search Path 配置没生效直接打开 Project Options 把安装目录下的Source子目录添加进搜索路径再编译就通了。3.3 把许可证文件加入工程版本管理已注册正式版的许可证最好按「开发机授权」和「部署运行时授权」分开看待。开发机上许可证文件放在安装目录即可IDE 编译时自动识别但编译出来的程序发给用户时默认行为取决于你设置的发布模式。有些版本支持把授权信息以资源文件方式嵌入 exe有些则要求发布目录存在许可证文件。我一般会把 license 文件复制到工程根目录下的3rd party license文件夹内并写入版本控制的只读分支防止被误删或误改。同时发布脚本里固定带上这个文件复制到输出目录。如果你没有做这一步等到程序在其他机器上运行半年后某天突然弹出授权异常排查起来会非常被动。// 在工程初始化处检查许可证文件是否存在 // 兼容开发环境与目标机器两种路径 procedure CheckLicFile; begin if not FileExists(ExtractFilePath(Application.ExeName) trv_lic.txt) then LogWarn(License file missing, functionality may be limited); end;逻辑说明这段代码只是做启动期提醒不阻断运行。正式版如果没有外发许可证文件部分高级功能会回退到试用模式提前检查可以避免上线后才发现。参数说明文件名要和实际授权文件名严格一致大小写也要对上某些系统环境下大小写不敏感但建议保持一致减少不确定性。4. 从零跑通一个最小编辑器搭建、加载、保存与缩放打印4.1 放置组件并建立数据通路在窗体上放一个 TRichView 作为编辑区再放一个 ScaleRichView 做预览。TRichView 的OnClick、OnChange事件要响应文档变更让右侧预览实时刷新。实际操作上我通常把 TRichView 放在左边ScaleRichView 放在右边中间用 Splitter 分隔形成双栏编辑预览布局。建立数据通路的核心是设置两边共享的文档变量。TRichView 自身有一个内置文档ScaleRichView 也有一个内部文档要做的就是把这两个文档对象设置为同一个。TRichView 的RVData属性就是它的文档数据层ScaleRichView 可以在设计期指定RichView属性这样它会自动读取同一份文档数据源无需额外写同步代码。属性/事件推荐值作用RVData默认内置文档数据承载ScaleRichView.RichView指向编辑控件共享文档对象TrackingModervtrkScaleRichView缩放时同步视觉反馈OnDocumentChange刷新预览内容变更入口4.2 文档加载与保存的代码骨架文档对象建立好后加载和保存是这个阶段的重点。TRichView 支持加载 RVF、RTF、HTML 等格式。注意区分RVF 是它自己的原生格式信息保留最完整RTF 用于和 Word 交换HTML 用于 Web 展示。保存逻辑上草稿箱用 RVF导出用 RTF这个习惯能最大程度避免来回转换的精度损失。procedure TFormMain.OpenRvfFile(const AFileName: string); begin // 加载 RVF 文档clear 掉当前内容再读入避免残留旧数据 RichView1.Clear; RichView1.LoadRVF(AFileName); // 通知 ScaleRichView 重新排版 ScaleRichView1.ReformatAll; end; procedure TFormMain.SaveToRtf(const AFileName: string); begin // 保存为 RTF供外部程序打开 RichView1.SaveRTF(AFileName); end;逻辑说明加载前先 Clear 是必须的否则上次的内容还在文档流里新内容会追加在末尾。ReformatAll在图片较多或长文档时开销较高但如果加载后不调用分页预览不会正确更新。参数说明SaveRTF可以带第二个参数指定保存选项集合比如是否导出文档属性按需保留默认调用一般就够用。4.3 让 ScaleRichView 真正「所见即所得」缩放与打印配置ScaleRichView 最有价值的设计就是它的缩放比例和页面概念。设计文档时ScaleRichView 可以设定页面宽度等于显示宽度编辑时按 100% 缩放然后通过缩放比例调整视图放大缩小。打印时页面尺寸以实际纸张为准所有坐标计算由控件自身完成不需要开发者手写毫米到像素的转换函数。procedure TFormMain.SetupPrint(AWidthMM, AHeightMM: Integer); begin // 设置页面尺寸A4 常见为 210 x 297 ScaleRichView1.PageWidth : AWidthMM; ScaleRichView1.PageHeight : AHeightMM; // 打印设置页边距注意为毫米单位 ScaleRichView1.LeftMargin : 20; ScaleRichView1.RightMargin : 15; // 启动打印并显示标准选项对话框 ScaleRichView1.PrintPreview; end;逻辑说明PrintPreview是一个快速预览入口适合用户点「预览」按钮时的路径实际要调打印机一般接Print方法并传入打印对话框结果。多个参数注意单位页边距、页面宽高等在 ScaleRichView 中通常以毫米为逻辑单位控件内部会做像素换算。如果你从别人代码里拷来一套设置却发现打印偏了最先检查的就是单位不一致问题——前面用的是毫米后面写成了像素就会出现整页内容偏移的玄学现象。4.4 用最小样例验证 API 是否通一个典型的「最小工程验证」顺序是加载 RVF 文件 - 修改文本 - 保存回到 RVF - 调用打印预览。这个步骤走通说明安装、授权、组件引用三条链路都没问题。如果在这一步发现某个方法找不到优先怀疑版本不匹配比如你用 21.6 的控件去调用旧博客里的方法签名会编译不过。procedure TFormMain.MinimalSanityTest; begin // 手工注入一段带样式的文本 RichView1.Clear; RichView1.AddText(Testing TRichView VersionStr, RichView1.Style.TextStyles[0]); // 保存到内存流而不是文件便于进一步处理 var ms : TMemoryStream.Create; try RichView1.SaveRVFToStream(ms); ms.Position : 0; RichView1.LoadRVFFromStream(ms); finally ms.Free; end; end;逻辑说明SaveRVFToStream 和 LoadRVFFromStream 是流式操作可以省去临时文件读写。验证目标是确认序列化和反序列化经过一圈后内容完整。在正式接数据库保存之前我建议在所有项目里跑一次这个自检它能排掉组件安装残缺的低级问题而不是到联调阶段才发现LoadRVF读出来一片空白。参数说明Style.TextStyles[0]表示引用第一个内置字符样式具体索引依赖当前样式表设置。5. 避坑记录从安装到打印最容易翻车的 5 个地方5.1 现象组件面板上找不到 ScaleRichView 图标安装完组件后打开 IDE 的新窗体组件面板里只有 TRichView没有 ScaleRichView。原因通常是只编译了 TRichView 的包而 ScaleRichView 拥有独立的设计期包两者是分开的。处理办法是回到安装目录把ScaleRichView文件夹下对应 Delphi 版本的.dpk也编译并安装两个包互不替代。5.2 现象编译报错提示无法定位dcu工程能打开但一编译就报找不到.dcu。这大概率是 Search Path 配置问题。TRichView 21.6 的安装目录中源码文件分布在Source和Source\RVDefs等不同子目录IDE 的 Library Path 只配了顶层目录没有递归包含子目录导致部分.dcu搜索不到。解决方法是逐一把这些子目录加入 Project Options 的 Search Path不要嫌多少了必然翻车。5.3 现象RTF 加载后中文字体变成方块加载含中文的 RTF 文件显示成方形占位符。原因不是控件不支持文字而是当前文档样式表里没有匹配中文字体的样式或者字体回退设置不对。处理方式是检查Style.TextStyles[0].FontName如果字体在目标机器上不存在就需要设置合理的字体替换链。还有个隐藏细节部分中文字体文件名在 Delphi 的旧版本里识别为 ANSI 字符集Unicode 版本的 TRichView 对字符集属性更敏感加载后要显式刷新字符集设置。5.4 现象打印预览正常但实际打印内容偏出纸边这是 ScaleRichView 配置中最常见的「搁置问题」之一。预览显示正常打印机输出后内容右移或下移几毫米。原因大概率是打印机的非对称页边距与控件内部计算不一致尤其是 A4 纸打印到非 A4 设置的打印机驱动上。我处理这类问题的习惯是打印机对话框中选择「跟随系统默认页边距」然后在 PageSetup 中把打印机边距与逻辑边距分开设置。5.5 现象RVF 在版本升级后读取失败项目积累了一堆历史 RVF 文件升级到新版 TRichView 后读不出来或布局错乱。原因在于 RVF 格式本身向下兼容良好但如果你在旧版本中启用了某些专有扩展新版本读取时对扩展字段的校验更严格。解决方法是保留一份升级前的控件版本做数据迁移工具把存量 RVF 转成标准格式后再让新版本接管不要在生产环境中直接用新版改写旧数据文件。6. 进阶技巧用 RVF 做文档增量保存并验证布局还原在日常应用中文档保存频率会影响用户体验。整篇 RTF 全部重写遇到大文档会有卡顿感而 RVF 流式接口天然支持增量写入可以把编辑操作按段落或区块序列化。我一般会利用 TRichView 的SaveRVFToStream将文档分成头部定义和内容区间分别存储头部保存样式表内容区间只存文本结构和图片引用这样每次自动保存只需要更新内容区间的数据块样式定义在固定的头部记录里写入量明显减少。验证布局还原有个实用技巧用工具箱生成一个带表格、图片和标题的测试文档保存为 RVF再切换不同的缩放比例和页面尺寸重新加载。布局还原的判断标准不是逐像素对比而是确认段落分页行数与表格行高一致。如果你发现某个测试样例在 100% 缩放和 150% 缩放下的分页结果不同那就说明文档中可能存在绝对定位的浮动对象需要检查它的坐标是否受缩放影响。function TFormMain.ValidateLayoutReuse(const AFileName: string): Boolean; var TestRtf: TRichView; begin Result : False; TestRtf : TRichView.Create(nil); try TestRtf.LoadRVF(AFileName); // 记录第一个分页断点位置 // 简单验证加载后文档点击数大于0 且样式表数量正常 Result : (TestRtf.RVData.GetItemsCount 0) and (TestRtf.Style.TextStyles.Count 1); finally TestRtf.Free; end; end;逻辑说明这是一个轻量级的自检函数在文档保存前调用确认 RVF 本身没有被写坏。样例逻辑里用的是通用的 item 数量判断实际项目中可以扩展为对特定段落样式的存在性校验。我见过的多数诡异问题比如打开文档后表格边框消失、图片丢失都是因为保存链路中某一步对文档做了隐式修改比如加载时自动把图片路径解析了用这个函数做保存前校验能比用户反馈更早发现问题。说到最后留一个自己的习惯每次升级控件后不要在旧工程上直接改我会先建一个独立验证工程把样例文档在旧版本读出、再用新版本写入对比二进制差异和重新加载后的布局状态。这种「回环测试」做多了之后你对 RVF 格式的信任度会明显提升也敢把它应用到更核心的模块里。这套组合的性价比在于投入一次安装配置的时间后续所有文档相关需求都能在统一的能力上生长省掉的是长期重复造轮子的成本。希望帮到你。本文还有配套的精品资源点击获取