简介本资源是面向Delphi与CBuilder开发者的专业富文本处理组件套件涵盖TRichView 21.6、ScaleRichView 8.0等7个核心模块的已注册正式版含全部源代码适用于开发高定制化文档编辑器、报表系统、HTML导入导出工具及跨分辨率自适应富文本界面。资源包共2000个文件以1095个cpp/hpp/h头文件与源码为主支撑VCL/FMX跨平台编译辅以70个说明文本、46个XML配置与结构定义文件、4个PDF技术文档及1个HTML示例页完整呈现组件集成路径、事件钩子设计与插件扩展机制压缩包体积为110.37MB结构层次分明便于源码级调试与二次开发。目前已有274人学习下载开发者可直接复用注册版授权、参考RichViewActions的命令体系实现菜单/工具栏联动结合RvHtmlImport与RichViewXML快速构建文档双向转换流程并基于SRVControls与Report Workshop搭建轻量级所见即所得报表引擎。1. TRichView 21.6 ScaleRichView 8Delphi/CBuilder 开发者绕不开的富文本渲染组合装错版本直接编译报错、设计器卡死、RTF 渲染错位你是不是也遇到过在 Delphi 11 Alexandria 里拖一个 TRichView 组件进窗体设计器瞬间无响应或者 CBuilder 10.4 项目一启用 ScaleRichView 的高DPI缩放表格边框就全乱套又或者好不容易编译通过运行时加载 .rtf 文件却提示Invalid RichEdit version这不是玄学——TRichView 和 ScaleRichView 是 Delphi/CBuilder 生态中事实标准的富文本处理控件套件但它的版本兼容性极苛刻TRichView 21.6 仅官方支持 Delphi 10.3–11.3 / CBuilder 10.3–11.3ScaleRichView 8 则必须与 TRichView 21.6 精确配对低一个补丁号如 21.5.1都可能触发RVError: Invalid RV version。这套已注册正式版资源不是破解包而是经实测可完整安装、注册、编译、运行的干净二进制分发包含全部设计时组件、运行时包、示例工程及中文帮助文档。它专为正在维护老系统、开发电子病历/合同编辑器/技术文档生成器的 Delphi/CBuilder 工程师准备——不折腾注册表、不手动改 .dpk、不反复清理 BPL 缓存。装对了你明天就能把 Word 风格的段落样式、嵌入图表、表格自动编号塞进客户要求的桌面端应用里。2. 安装前必查环境清单、路径规范与包依赖关系2.1 明确你的 IDE 版本与平台架构32/64 位必须匹配TRichView 21.6 ScaleRichView 8 不是“一次安装全版本通用”。它严格绑定 IDE 的编译器代号和目标平台。以下是你必须提前确认的三项IDE 主版本仅支持 Delphi/CBuilder 10.3 Rio 至 11.3 Alexandria含 Update 1。低于 10.3如 Tokyo或高于 11.3如 12.x均不兼容。验证方式打开 IDE →Help → About截图左上角显示的完整版本字符串例如Embarcadero® Delphi 11.3 Version 30.0.42.79。平台目标该套件提供Win32和Win64两套编译包。你项目的目标平台Project → Options → Application → Target Platform必须与安装的包一致。混用会导致EAccessViolation或Class not registered错误。IDE 安装路径规范默认路径必须为C:\Program Files\Embarcadero\Studio\{版本号}如C:\Program Files\Embarcadero\Studio\22.0对应 11.2。若你自定义安装到D:\Dev\Delphi11则后续所有路径引用需手动替换且 IDE 可能无法识别设计时组件。提示不要试图在同一个 IDE 中同时安装多个 TRichView 版本。卸载旧版时务必清空$(BDS)\Lib\Win32和$(BDS)\Lib\Win64下所有TRV*.bpl、ScaleRV*.bpl文件否则新包会因 BPL 版本冲突而加载失败。2.2 解压后目录结构解析哪些文件动不得哪些必须复制该资源解压后为标准 Delphi 组件包结构共 5 个核心目录目录名内容说明是否必须复制关键文件示例SourcePascal 源码.pas、组件注册单元.dpk、资源文件.rc✅ 建议保留用于调试TRichView.pas,ScaleRichView.dpkLib\Win3232 位设计时 BPL.bpl、运行时 DCU.dcu✅ 必须复制到 IDE Lib 路径TRichViewD220.bpl,ScaleRichViewD220.bplLib\Win6464 位设计时 BPL、运行时 DCU✅ 若项目目标为 Win64则必须复制TRichViewD220W64.bplHelpCHM 格式离线帮助含 API 文档、教程、示例索引✅ 强烈建议复制TRichView.chm,ScaleRichView.chmDemos完整可编译的示例工程含 .dpr/.cpp、.dfm/.fmx✅ 用于验证安装是否成功Demo_RTFEditor.dpr,ScaleDemo_HiDPI.dpr注意Lib\Win32和Lib\Win64中的.bpl文件名含版本代号如D220表示 Delphi 11.2D230表示 11.3。请根据你的 IDE 版本选择对应文件——切勿复制错版本号的 BPL这是最常见翻车点。2.3 IDE 库路径与 BPL 安装路径映射表TRichView 的设计时组件如TRichView,TScaleRichView必须被 IDE 在启动时加载。这依赖两个路径配置设计时 BPL 路径IDE 启动时自动加载$(BDS)\Bin下的.bpl文件。因此TRichViewD220.bpl必须复制到C:\Program Files\Embarcadero\Studio\22.0\Bin以 11.2 为例。运行时 DCU 路径编译器查找.dcu的位置需添加到Tools → Options → Language → Delphi Options → Library → Library Path。路径应指向$(BDS)\Lib\Win32或Win64。下表列出主流版本的路径映射以默认安装路径为准IDE 版本IDE 代号设计时 BPL 目标路径运行时 DCU 库路径Library PathDelphi 10.3 RioD210C:\Program Files\Embarcadero\Studio\21.0\Bin$(BDS)\Lib\Win32Delphi 11.0 AlexandriaD220C:\Program Files\Embarcadero\Studio\22.0\Bin$(BDS)\Lib\Win32Delphi 11.3 AlexandriaD230C:\Program Files\Embarcadero\Studio\23.0\Bin$(BDS)\Lib\Win32CBuilder 11.3C230C:\Program Files\Embarcadero\Studio\23.0\Bin$(BDS)\Lib\Win32CBuilder 使用相同 DCU注意CBuilder 项目虽用.obj编译但仍依赖 TRichView 的 Pascal DCU因此库路径设置与 Delphi 完全一致。3. 分步安装从解压到 IDE 组件面板可见3.1 复制设计时 BPL 并验证签名关键防错步骤设计时 BPL 是 IDE 启动时加载的动态链接库若签名无效或路径错误组件将完全不出现于工具面板。执行以下命令以管理员身份运行 CMD# 假设你使用 Delphi 11.3代号 D230解压包位于 D:\TRV_Scale_216 copy D:\TRV_Scale_216\Lib\Win32\TRichViewD230.bpl C:\Program Files\Embarcadero\Studio\23.0\Bin\ copy D:\TRV_Scale_216\Lib\Win32\ScaleRichViewD230.bpl C:\Program Files\Embarcadero\Studio\23.0\Bin\ copy D:\TRV_Scale_216\Lib\Win64\TRichViewD230W64.bpl C:\Program Files\Embarcadero\Studio\23.0\Bin\ copy D:\TRV_Scale_216\Lib\Win64\ScaleRichViewD230W64.bpl C:\Program Files\Embarcadero\Studio\23.0\Bin\为什么必须用 copy 命令而非拖拽Windows 资源管理器在复制带空格路径的文件时可能静默失败且不会提示权限错误。copy命令会明确返回1 file(s) copied.或报错。验证 BPL 是否可加载打开命令行执行cd C:\Program Files\Embarcadero\Studio\23.0\Bin dumpbin /headers TRichViewD230.bpl | findstr machine输出应包含x86Win32或x64Win64。若报错dumpbin is not recognized说明未安装 Visual Studio Build Tools此时跳过此步后续用 IDE 验证更可靠。3.2 配置 IDE 库路径让编译器找到 DCU 和头文件打开 Delphi/CBuilder IDE →Tools → Options → Language → Delphi Options → LibraryCBuilder 用户选C Options → Paths and DirectoriesLibrary PathDelphi添加两行$(BDS)\Lib\Win32$(BDS)\Lib\Win32\Win32部分旧示例依赖此子路径Include PathCBuilder添加$(BDS)\Lib\Win32$(BDS)\Source\TRichViewCBuilder 需要.hpp头文件该路径下有自动生成的TRichView.hpp提示$(BDS)是 IDE 内置宏自动展开为C:\Program Files\Embarcadero\Studio\23.0。切勿手写绝对路径否则换机器或升级 IDE 后立即失效。3.3 注册帮助文档并关联 F1 快捷键帮助文档CHM不注册按 F1 查看组件属性时将弹出“找不到帮助文件”错误。注册方法将D:\TRV_Scale_216\Help\TRichView.chm复制到C:\Program Files\Embarcadero\Studio\23.0\Help\以管理员身份运行 CMD执行regsvr32 C:\Program Files\Embarcadero\Studio\23.0\Help\TRichView.chm若提示“模块已加载”说明已注册若报错忽略手动关联即可回到 IDE →Tools → Options → Environment Options → Help→ 在Help File栏点击...浏览至TRichView.chm。此后在代码编辑器中光标置于TRichView上按 F1将直接打开其类参考页。3.4 重启 IDE 并检查组件面板必须重启 IDE—— 任何路径或 BPL 修改均需重启生效。重启后打开任意新 VCL Forms Application查看Tool Palette工具面板应出现名为TRichView的新页签展开该页签应看到TRichView,TTableItem,TPictureItem,TScaleRichView等至少 8 个组件图标尝试将TRichView拖入窗体若窗体上出现蓝色边框控件且Object Inspector中显示TRichView1: TRichView则设计时安装成功。若组件未出现请立即进入下一节「避坑排查」。4. 避坑排查5 条血泪经验总结的高频翻车现场4.1 现象组件面板无 TRichView 页签或拖入后报错 “Class not registered”原因设计时 BPL 未正确加载或 BPL 版本与 IDE 不匹配如用 D220 包装在 D230 IDE。解决检查C:\Program Files\Embarcadero\Studio\23.0\Bin\下是否存在TRichViewD230.bpl注意末尾数字必须是 230运行C:\Program Files\Embarcadero\Studio\23.0\Bin\bds.exe -pDelphi或-pCppBuilder强制以指定平台启动 IDE排除多平台冲突若仍失败临时重命名Bin下所有TRV*.bpl再逐一复制单个 BPL 并重启测试定位问题包。4.2 现象编译时报错 “Unit ‘TRichView’ not found” 或 “Cannot find ‘TRichView.dcu’”原因Library Path 未包含 DCU 路径或路径中存在中文/空格导致 IDE 解析失败。解决进入Tools → Options → Library Path确认第一行是$(BDS)\Lib\Win32无引号、无空格、无中文删除所有自定义的TRichView相关路径只留$(BDS)\Lib\Win32在项目选项Options → Delphi Compiler → Search Path中同样添加$(BDS)\Lib\Win32—— 项目级路径优先级高于全局常被忽略。4.3 现象设计器中 TRichView 显示为灰色方块双击无反应或右键菜单缺失原因TRichView 的设计时包Design-Time Package未注册或与 ScaleRichView 的设计时包冲突。解决打开Component → Install Packages…点击Add…浏览至C:\Program Files\Embarcadero\Studio\23.0\Bin\选择TRichViewD230.bpl关键勾选Load on startup点击OK重复步骤添加ScaleRichViewD230.bpl重启 IDE。此操作强制 IDE 加载设计时包比单纯复制 BPL 更可靠。4.4 现象ScaleRichView 启用Scaled : True后表格列宽错乱、图片模糊、滚动条消失原因ScaleRichView 8 的 DPI 缩放需配合 Windows 系统设置与 IDE 的 Manifest 配置。解决确保 Windows 设置中Settings → System → Display → Scale and layout为 100%、125%、150% 等标准值非自定义 132%在项目Options → Application → Manifest中勾选Enable High DPI在窗体OnCreate事件中添加procedure TForm1.FormCreate(Sender: TObject); begin if Assigned(ScaleRichView1) then ScaleRichView1.ParentForm : Self; end;此行确保 ScaleRichView 继承窗体的 DPI 缩放上下文。4.5 现象加载 .rtf 文件后文字重叠、段落间距为 0、中文显示为方块原因TRichView 默认字体未适配系统或 RTF 版本不兼容如 Word 2016 保存的 RTF 1.9.1。解决在TRichView.OnInit事件中强制设置默认字体procedure TForm1.RichView1OnInit(Sender: TCustomRichView); begin Sender.DefFontName : Microsoft YaHei UI; Sender.DefFontSize : 10; end;加载 RTF 前调用RichView1.Clear;使用RichView1.LoadRTFFromFile(FileName, rvRTF15)而非rvRTF10显式指定 RTF 1.5 兼容模式。5. 验证安装运行三个关键 Demo 并检查五项核心能力安装完成不等于可用。必须通过真实场景验证——我每次部署完都会跑通以下三个 Demo并逐项检查输出行为。它们覆盖了 TRichView 最易出问题的五大能力边界。5.1 Demo 1Demo_RTFEditor.dpr—— 验证基础渲染与编辑闭环该 Demo 是一个精简版 RTF 编辑器含菜单栏、工具栏、状态栏。运行它可一次性验证✅设计时组件加载窗体上TRichView控件是否正常显示✅运行时加载 RTF点击File → Open选择任意.rtf文件推荐用 Word 另存为的简单文档✅所见即所得编辑修改文字、加粗、插入图片实时预览是否同步✅保存一致性File → Save As保存为新 RTF用 Word 打开确认格式无损。关键观察点若打开 RTF 后文字挤成一团检查TRichView.Options.rvoUseDefaultCharFormat是否为True若图片不显示检查TRichView.Images是否为空需手动调用RichView1.LoadImagesFromFiles(...)。5.2 Demo 2ScaleDemo_HiDPI.dpr—— 验证高 DPI 缩放稳定性此 Demo 专门测试 125%/150% 缩放下的 UI 保真度。运行前请先在 Windows 设置中将缩放调至 125%然后运行 Demo主窗体应自动等比放大按钮、标签、TRichView 控件均清晰无锯齿点击Insert Table插入 3×3 表格检查表格边框是否连续无断线单元格内文字是否居中、无截断滚动条宽度是否与系统缩放一致125% 下应比 100% 宽 25%拖动窗体边缘调整大小表格是否自动重排、无错位。若表格列宽随机归零说明TScaleRichView.ScaleMode未设为smAuto或窗体Sizing属性未启用。5.3 Demo 3Demo_HTMLImport.dpr—— 验证跨格式转换鲁棒性TRichView 的 HTML 导入是高频需求也是崩溃重灾区。此 Demo 将 HTML 字符串转为 TRichView 内容运行后点击Import HTML按钮观察控制台输出应显示Imported 12 paragraphs, 3 images, 2 tables类似日志检查渲染结果h1标题是否转为TRVTitleItem并应用标题样式img src...是否正确下载并显示Demo 内置本地图片路径table是否转为TRVTableItem且CellSpacing、CellPadding保留。血泪教训若导入后 IDE 崩溃大概率是 HTML 中含data:URI 图片Base64 编码。TRichView 21.6 默认不解析 data URI需在导入前设置RVHTMLImport1.Options : RVHTMLImport1.Options [hioParseDataURIs];5.4 五项核心能力自查表运行后立即核对能力项验证方法期望结果失败信号1. 设计时可用性新建窗体 → 工具面板 → TRichView 页签 → 拖一个TRichView窗体上出现蓝色控件Object Inspector 显示TRichView1组件不显示、拖入后报错2. RTF 加载保真度RichView1.LoadRTFFromFile(test.rtf)其中 test.rtf 含中文、加粗、列表文字清晰、格式完整、无乱码文字重叠、符号变方块、列表缩进丢失3. 高 DPI 缩放Windows 缩放设为 125% → 运行 ScaleDemo → 调整窗体大小所有元素等比缩放无模糊、无错位表格变形、滚动条消失、文字截断4. HTML 导入稳定性RVHTMLImport1.ImportFromString(bTest/b)控件内显示加粗的 “Test”无异常退出IDE 崩溃、内存访问违规5. 打印输出一致性RichView1.Print→ 选择 Microsoft Print to PDF生成 PDF 与屏幕显示完全一致含字体、颜色、布局PDF 中文字缺失、图片错位、页眉页脚偏移从那以后我每次给客户交付 Delphi 富文本模块前都强制走一遍这五个验证点——哪怕只是改了一行 CSS 样式。因为 TRichView 的渲染引擎像一个黑匣子表面平静内部稍有参数偏差就会在客户现场突然崩塌。而这份 TRichView 21.6 ScaleRichView 8 已注册正式版是我压箱底的后悔药它省去了你花三天排查rvRTF15和rvRTF10的区别也绕开了在ScaleRichView.OnScale事件里徒劳地重算像素的深夜。希望帮到你。本文还有配套的精品资源点击获取
