sgcDocs 功能矩阵
sgcDocs 的全部功能,按组件分组。sgcDocs 包含在 sgcUI Enterprise 和 All-Access 中,不作为单独的产品销售,每个许可证都包含全部功能,也没有 Community 版。它无需安装 Office,也无需任何界面框架,可在 Windows 和 Linux64 上运行。
sgcDocs 的全部功能,按组件分组。sgcDocs 包含在 sgcUI Enterprise 和 All-Access 中,不作为单独的产品销售,每个许可证都包含全部功能,也没有 Community 版。它无需安装 Office,也无需任何界面框架,可在 Windows 和 Linux64 上运行。
| 组件 | 详情 |
|---|---|
TsgcDocsWordProcessor | 加载、创建、编辑和保存 Word 文档:DOCX、RTF、HTML、Markdown 和文本的读写,PDF、PNG 和 SVG 页面,搜索和替换,域,邮件合并和保护。 |
TsgcDocsMailMerge | Word 处理器的邮件合并引擎,支持 MERGEFIELD 和 IF 域、区域,以及 CSV、JSON、数据集和事件数据源。 |
TsgcDocsSpreadsheet | 加载、创建、计算和保存工作簿:XLSX、ODS 和 CSV 的读写,公式,格式,合并单元格,图表,页面设置,以及 PDF、HTML 和 PNG 输出。 |
TsgcDocsPDFProcessor | 打开、编辑和写入 PDF 文件:页面、文本、PNG 页面、加密、表单、PDF/A、数字签名,以及 HTML 和图像转 PDF。 |
TsgcDocsBarcode | 11 种一维和二维条形码,输出为 PNG、SVG 或 PDF,或绘制在 PDF 页面上。 |
TsgcDocsZipArchive | 支持 ZIP64、UTF-8 名称、条目元数据、进度和路径遍历防护的 ZIP 压缩包。 |
TsgcDocsConverter | 通过一次调用在上述格式之间转换,按文件扩展名或按流。 |
| 功能 | 详情 |
|---|---|
| 格式 | 读写 DOCX、RTF、HTML、Markdown 和文本;dfAuto 根据文件扩展名和内容检测格式。 |
| 文档模型 | 段落、样式、列表、表格、图像、节、页眉和页脚、域、脚注、尾注和书签,通过 sgcRichEdit 的文档模型提供。 |
| 构建文档 | 使用样式名称(如 Heading 1)的 AppendParagraph、AppendTable、AppendImage(PNG、JPEG、GIF、BMP 和 SVG)、分页符和分节符。 |
| PDF 导出 | ExportToPDFFile 写出排好版的页面,默认带有标题、列表和表格结构的标签,需要时可输出为 PDF/A。 |
| PNG 和 SVG 页面 | ExportPageToPNG 支持 1 至 2400 dpi,ExportPageToSVG 每次导出一页。 |
| 搜索和替换 | 在正文、表格、页眉、页脚、脚注和尾注中使用 SearchText 和 ReplaceAll。替换后的文本保留匹配文本的字符格式。 |
| 域 | UpdateFields 更新 DATE、TIME、PAGE 和 NUMPAGES,RemoveFields 取消所有域的链接。 |
| 页码和注释 | 按节设置页码,带起始值,支持十进制、罗马数字或字母格式,脚注和尾注各有一种标记格式。 |
| 保护 | Word 强制执行的只读、批注、修订和表单保护。新密码以带盐值的 SHA-512 哈希存储,CheckPassword 也可检查 Word 2007 文档的旧版哈希。 |
| 字体 | AddFontFile 和 AddFontFolder 为排版以及 PDF、PNG 和 SVG 输出添加 TrueType 字体,适用于字体很少的服务器。 |
| 功能 | 详情 |
|---|---|
| 模板 | 用 Word 制作、带 MERGEFIELD 域的普通 DOCX,或用 AppendField 在代码中构建的文档。页眉、页脚、脚注、尾注和表格单元格中的域也会被合并。 |
| 开关 | 大写、小写、首字母大写和标题大小写,数字图片(如 \# ,0.00),日期图片(如 \@ "MMMM d, yyyy"),以及在非空值前后添加的文本。 |
| IF 域 | 使用 = <> < > <= >= 的比较,数值或文本,通配符,以及操作数和文本中的嵌套域。 |
| 区域 | 从 TableStart:Name 到 TableEnd:Name 的区域按每条子记录重复一次表格行,或段落和表格。区域可以嵌套。 |
| 数据源 | TsgcDocsMergeJSON、TsgcDocsMergeCSV、适用于任意带主从关系 TDataSet 的 TsgcDocsMergeDataSet,以及适用于应用程序自身数据的 TsgcDocsMergeEvents。 |
| 输出 | MailMerge 把所有记录写入一个文档,记录之间用分节符、分页符或不加分隔。MailMergeEach 为每条记录写一个文件(包括 PDF),文件名中带记录编号和字段值。 |
| 选项 | 没有值的域可被删除、保留或报告为错误。域可以保留更新后的结果,使文档能再次合并,空段落可被删除,值可被修剪。 |
| 功能 | 详情 |
|---|---|
| 格式 | 读写 XLSX 和 ODS,包括值、公式、样式、合并单元格和图表,以及使用检测到的或固定分隔符的 CSV。 |
| 单元格 | 按 Excel 地址使用 Values、Formulas 和 Text,用 SetRange 写入 Variant 数组,以及 UsedRange 和 Clear。 |
| 公式引擎 | 320 个 Excel 函数,涵盖逻辑、数学、统计、财务、文本、日期和时间、查找和引用、工程等类别,支持动态数组。Evaluate 针对工作簿运行任意公式。 |
| LET 和 LAMBDA | LET、LAMBDA、用 DefineName 定义的命名 LAMBDA 函数,以及 MAP、REDUCE、SCAN、BYROW 和 BYCOL。 |
| 单元格格式 | 字体、字号、粗体、斜体、颜色、填充、对齐、数字格式、合并单元格、列宽和行高。 |
| 条件格式 | 加载和保存 XLSX 文件时予以保留,支持 15 种 Excel 规则类型中的 10 种。 |
| 图表 | 工作表的图表可从 XLSX 加载并保存到 XLSX,随工作表一起打印,并以内联 SVG 形式写入 HTML。 |
| 工作表 | AddSheet、DeleteSheet 和 RenameSheet,后者会重写引用该工作表的公式。 |
| 数据集 | ImportDataSet 把数据集的可见字段复制到工作表中,并带标题行。 |
| 保护 | 带解锁单元格的工作表保护,以及工作簿保护。 |
| 功能 | 详情 |
|---|---|
| 分页 | 工作表按 Excel 的打印方式分页,用 ExportToPDFFile 写为 PDF,用 ExportSheetPageToPNG 写为 PNG,用 ExportToHTML 写为 HTML。 |
| 页面设置 | 方向、纸张大小、缩放或适应页宽和页高、页边距、居中、网格线和标题,可从工作簿读取,也可通过 PageSetup 设置。 |
| 打印区域和标题 | 打印区域、在每页重复的标题行和标题列,以及页眉和页脚代码。 |
| 功能 | 详情 |
|---|---|
| 页面 | Merge、按页范围 Split、 ExtractPages、DeletePages、MovePage 和 RotatePages。 |
| 文本 | ExtractText 提取一页或所有页的文本,SearchText 查找包含某段文本的页面。 |
| PNG 页面 | RenderPageToPNGFile 支持 1 至 2400 dpi,并应用页面旋转。 |
| 加密 | RC4 40 位和 128 位、AES-128 和 AES-256,带打印、修改、复制、注释、填写表单、提取和组装权限。加密文件可用用户密码或所有者密码打开,Decrypt 可移除加密。 |
| 表单 | 按名称读取和设置 AcroForm 字段,从 Name=Value 行填写,并把它们展平到页面中。 |
| PDF/A | ConvertToPDFA 支持 PDF/A-1b、2b、3b、1a、2a、3a、4 和 4f,ValidatePDFA 给出错误和警告报告。 |
| 数字签名 | 在所有平台上通过 OnExternalSign 调用 Sign,适用于 HSM、云密钥或 sgcSign。在 Windows 上可使用 SignWithPFX 和 SignWithThumbprint。 |
| HTML 和图像转 PDF | LoadFromHTML 渲染带 CSS 的 HTML,AddImagePage 把 JPEG、PNG、BMP 或 TIFF 图像添加为一页,按原始大小或适应 A4 或 Letter。 |
| 功能 | 详情 |
|---|---|
| 种类 | Code 128、Code 39、EAN-13、EAN-8、UPC-A、ITF、Codabar、QR Code、Data Matrix、PDF417 和 GS1-128。 |
| 验证 | Validate 检查长度、数字、校验位、字符集、GS1 应用标识符和二维码容量。EAN-13、EAN-8 和 UPC-A 会补上缺失的校验位。 |
| 输出 | PNG、SVG 和单页矢量 PDF,或用 DrawToPDFPage 绘制到现有 PDF 页面的某个方框中。 |
| 选项 | 模块大小、静区、颜色、一维符号下方的文本、条高以及 QR Code 纠错级别。 |
| 功能 | 详情 |
|---|---|
| ZIP64 | 超过 4 GB 或条目超过 65,535 个的压缩包,deflate 或仅存储的条目,UTF-8 名称和条目时间。 |
| 创建 | AddFile、带掩码的 AddFolder、AddStream、AddText 和 AddEmptyFolder,输出到文件或流。 |
| 读取 | 带名称、大小、压缩后大小、CRC32 和时间的 Entries,ExtractTo,提取到流的 ExtractEntry,以及 ExtractEntryToFile 和 ReadText。 |
| 安全提取 | 在写入任何内容之前检查每个名称:包含 .. 段或绝对路径的压缩包会被拒绝。 |
| 进度 | 每个条目之前触发 OnProgress,并带有可停止操作的标志。 |
| 功能 | 详情 |
|---|---|
| 格式对 | 14 种格式之间共 63 个格式对。DOCX、RTF、HTML、Markdown 和文本之间可互相转换,也可转换为 PDF、PNG 和 SVG。XLSX、ODS 和 CSV 之间可互相转换,也可转换为 HTML、PDF 和 PNG。PDF 可转换为文本、PNG 和 PDF,图像可转换为 PDF。 |
| 文件和流 | Convert 从文件扩展名获取两种格式,ConvertStream 从内容检测源格式。CanConvert 可预先告知某个格式对是否受支持。 |
| 页面图像 | ConvertToImages 按您选择的分辨率为每页向文件夹写出一个 PNG 或 SVG。 |
| 图像转 PDF | ConvertImagesToPDF 为每张 PNG、JPEG、BMP 或 TIFF 图像生成一个 PDF 页面,按图像大小或适应 A4 或 Letter。 |
| PDF 选项 | Word 源文件输出带标签的 PDF,所有 PDF 输出可转换为您选择的 PDF/A 级别。 |
| 进度和错误 | OnProgress 报告加载、保存、页面和图像阶段。不受支持的格式对会引发 EsgcDocsUnsupportedFormat。 |
| 目标 | 组件 | 版本 |
|---|---|---|
| Delphi | 七个 sgcDocs 组件 | Delphi 7 至 13:Win32,以及 Delphi XE2 起的 Win64 |
| C++ Builder | 相同的类,带生成的 .hpp 头文件 | C++ Builder 2007 至 13 |
| Linux64 | 相同的单元,不含 VCL、FireMonkey 或 GDI 代码 | 控制台程序、守护进程和 Web 服务器。需要 libz.so.1 以及文档所用的 TrueType 字体 |
| 服务和 Web 服务器 | 每个线程一个组件实例;不同的实例并行运行 | 所有受支持的 Delphi 版本 |
| .NET | esegece.sgcDocs,命名空间 esegece.sgcDocs | .NET Standard 2.0、.NET Framework 4.7.2、.NET 6、8、9 和 10 |
类名和成员名相同的 C# 版本,位于命名空间 esegece.sgcDocs 中。该包仅提供 Registered 版,不在 nuget.org 上发布。
| 包 | 版本 | 内容 |
|---|---|---|
esegece.sgcDocs | Registered | 所有 sgcDocs 组件,转换矩阵与 Delphi 相同,另有适用于 DataTable、DataSet 表或 IDataReader 的 TsgcDocsMergeDataTable |
esegece.sgcUICore, esegece.sgcPDF, esegece.sgcRichEdit, esegece.sgcGrid, esegece.sgcSpreadsheet, esegece.sgcCharts | 依赖项 | sgcDocs 所依赖的引擎,随它一并安装 |
esegece.sgcUICore.Rendering | 可选 | 仅在需要写出文档和工作表的 PNG 和 SVG 页面时添加 |
sgcDocs 的文档包含在 sgcUI 帮助中,每种开发环境各有一个版本。