Delphi、C++ Builder 和 .NET sgcUI 的一部分

sgcDocs,适用于 Delphi、C++ Builder 和 .NET 的无界面 Office 文件 API

在桌面应用程序、Windows 服务或 Linux 服务器中创建、读取和转换 Word 文档与电子表格。sgcDocs 可执行邮件合并,把工作簿打印为 PDF,合并、拆分、填写、加密和签名 PDF 文件,生成条形码并创建 ZIP64 压缩包。它无需安装 Office,也无需任何界面框架,因为所有读取器、写入器和渲染器都是 Pascal 或 C# 代码。

无需安装 Office无需界面框架Windows 和 Linux64包含在 sgcUI Enterprise 中
sgcDocs 邮件合并代码,旁边是它生成的两个发票 PDF 文件,由 sgcDocs 渲染为 PNG

无需 Office 即可处理 Office 文件

sgcDocs 组件面板页上有七个非可视组件。下面是主要亮点,功能矩阵列出了全部功能。

Word 文档

读取、编辑和写入文档,然后与您的数据合并。

Word 文档

读取、编辑和写入 DOCX、RTF、HTML 和 Markdown

合同、报告和信函往往一开始就是用 Word 制作的 DOCX。TsgcDocsWordProcessor 可加载 DOCX、RTF、HTML、Markdown 和文本,保留节、页眉、页脚、域、脚注和书签,并能把文档保存为其中任何一种格式。它可以在正文、表格、页眉和页脚中搜索和替换文本,并把排好版的页面导出为 PDF、PNG 或 SVG。

  • 带有标题、列表和表格结构的带标签 PDF,以及 PDF/A
  • 1 至 2400 dpi 的 PNG 页面,以及 SVG 页面
  • 在文档的每个部分使用 SearchText 和 ReplaceAll
  • 只读、批注、修订和表单保护,密码哈希带有盐值

Word 文档

从 JSON、CSV、数据集或事件执行邮件合并

发票、信函和证书由一个模板和一组记录生成。MailMerge 把所有记录写入同一个文档,MailMergeEach 则为每条记录写一个文件(包括 PDF),文件名中可带记录编号和任意字段值。模板就是用 Word 制作的普通 DOCX,其中包含 MERGEFIELD 和 IF 域。

  • 数字、日期和大小写开关,例如 \# ,0.00 and \@ "MMMM d, yyyy"
  • 带嵌套域的 IF 域,以及按子记录重复表格行的区域
  • TsgcDocsMergeJSON, TsgcDocsMergeCSV, TsgcDocsMergeDataSet and TsgcDocsMergeEvents

电子表格

带有公式、格式和图表的工作簿,在服务器上计算和打印。

电子表格

XLSX、ODS 和 CSV,支持 320 个 Excel 函数

TsgcDocsSpreadsheet 无需用户界面即可加载、创建、计算和保存工作簿。单元格的寻址方式与 Excel 相同,以 = 开头的文本就是公式,公式引擎可计算 320 个 Excel 函数,包括 LET、LAMBDA 和命名 LAMBDA 函数。加载并再次保存 XLSX 文件时,格式、合并单元格、图表和条件格式都会保留。

  • 按单元格地址使用 Values、Formulas 和 Text,用 Evaluate 计算任意公式
  • 字体、填充、对齐、数字格式、列宽和行高
  • ImportDataSet 把数据集的行复制到工作表中
  • 工作表和工作簿保护

电子表格

把工作簿打印为 PDF、HTML 和 PNG

工作表按 Excel 的打印方式分页,页面设置保存在工作簿中:方向、纸张大小、缩放或适应页数、页边距、打印区域、打印标题、网格线以及页眉页脚代码。工作表中的图表会一并打印,ExportToHTML 为每个工作表写出一个 HTML 表格,图表以内联 SVG 形式输出。

  • ExportToPDFFile 可导出一个工作表或所有可见工作表
  • ExportSheetPageToPNG 导出一个打印页面
  • 打印区域、打印标题以及调整为一页宽

PDF、条形码和 ZIP

围绕文档的文件处理工作,都在同一个包中。

PDF 处理

合并、拆分、填写、加密和签名 PDF 文件

TsgcDocsPDFProcessor 可打开 PDF(包括加密的 PDF)并对其进行修改:合并文件,按页范围拆分,提取、删除、移动和旋转页面,读取并搜索文本,把页面渲染为 PNG。它可填写并展平 AcroForm 字段,用 AES-256 加密,转换为 PDF/A 并验证结果,还能把带 CSS 或图像的 HTML 转换为 PDF。

  • RC4 和 AES 加密,带打印、复制和修改权限
  • PDF/A-1、PDF/A-2、PDF/A-3 和 PDF/A-4 的转换与验证
  • 在所有平台上通过 OnExternalSign 进行数字签名,在 Windows 上还可使用 PFX 文件或证书存储区中的证书

条形码和 ZIP

条形码和 ZIP64 压缩包

TsgcDocsBarcode 可编码 11 种一维和二维符号,例如 Code 128、EAN-13、QR Code、Data Matrix 和 PDF417,验证数据并写出 PNG、SVG 或 PDF,也可把符号以矢量形式绘制在 PDF 页面上。TsgcDocsZipArchive 可创建和读取支持 ZIP64、UTF-8 名称和条目时间的 ZIP 压缩包,并在写入任何内容之前拒绝带有路径遍历名称的压缩包。

  • 11 种条形码,带校验位和 GS1 验证
  • ZIP64 支持超过 4 GB 或条目超过 65,535 个的压缩包
  • 每个条目的大小、压缩后大小、CRC32 和时间

转换与部署

一次调用即可完成转换,同样的代码可用于桌面和服务器。

转换

一次调用支持 63 种格式对

TsgcDocsConverter 在文档、电子表格、PDF 文件和图像之间转换文件和流。格式由文件扩展名确定,或从流的内容中检测,CanConvert 可预先告知某个格式对是否受支持。ConvertToImages 为每页写出一个 PNG 或 SVG,ConvertImagesToPDF 则为每张图像生成一个 PDF 页面。

  • DOCX、RTF、HTML、Markdown 和文本之间互相转换,也可转换为 PDF、PNG 和 SVG
  • XLSX、ODS 和 CSV 之间互相转换,也可转换为 HTML、PDF 和 PNG
  • PDF 转换为文本和 PNG,所有 PDF 输出在需要时均可生成 PDF/A

部署

同样的代码可在 Windows 和 Linux64 上运行

sgcDocs 单元不使用 VCL、FireMonkey 或 GDI 代码,也无需 Office,因此同样的代码可运行在控制台程序、Windows 服务、Linux64 守护进程或 Web 服务器中。组件不是线程安全的:请在处理请求的线程中创建该请求所需的组件,不同的实例可并行运行。在 Linux 上,请通过 AddFontFolder 或转换器的 Fonts 列表添加文档所用的 TrueType 字体。

  • Delphi 7 至 13 和 C++ Builder 2007 至 13
  • Win32、Win64 和 Linux64
  • .NET 包 esegece.sgcDocs,适用于 .NET Framework 4.7.2、.NET Standard 2.0 和 .NET 6 至 10

谁在用 sgcDocs 构建应用

由您的数据生成发票、信函和合同

业务应用程序用数据库记录或 JSON 文档填充用 Word 制作的 DOCX 模板,并为每位客户写出一个 PDF。用户继续在 Word 中编辑模板,而应用程序无需在机器上安装 Office。

  • 邮件合并
  • 每条记录一个文件
  • PDF 输出
运行 MailMerge 演示

运行在您自己服务器上的转换服务

门户网站和后台系统在 Linux 或 Windows 服务器上把上传的文档转换为 PDF、文本或页面图像,无需发送给第三方服务。每个请求都有自己的转换器,请求并行运行。

  • 63 种格式对
  • Linux64
  • REST 端点
运行 ConversionServer 演示

无需 Excel 的报表和导出

报表和会计应用程序创建带有公式、格式和图表的工作簿,在没有用户会话的服务中计算它们,并按工作簿的页面设置打印为 PDF。

  • 320 个 Excel 函数
  • 图表
  • 打印为 PDF
运行 SpreadsheetCreate 演示

几行代码即可填充、合并和转换

这些组件无需窗体,也无需父控件:用 nil 所有者创建它们,调用其方法,然后释放。

TsgcDocsWordProcessor 填充 DOCX 模板并将其导出为 PDF。TsgcDocsConverter 一次调用即可转换任何受支持的格式对,并为每页写出一个 PNG。

uses
  SysUtils, Classes,
  sgcDocs_Types, sgcDocs_Word, sgcDocs_Converter;

procedure ContractToPDF;
var
  oWord: TsgcDocsWordProcessor;
  oConverter: TsgcDocsConverter;
begin
  // fill a DOCX template made in Word, save it and export it to PDF
  oWord := TsgcDocsWordProcessor.Create(nil);
  try
    oWord.LoadFromFile('contract_template.docx');
    oWord.ReplaceAll('[CUSTOMER]', 'Anna Lopez');
    oWord.ReplaceAll('[DATE]', FormatDateTime('mmmm d, yyyy', Date));
    oWord.SaveToFile('contract.docx');
    oWord.ExportToPDFFile('contract.pdf');
    WriteLn('Pages: ', oWord.PageCount);
  finally
    oWord.Free;
  end;

  // one call conversions, the formats come from the file extensions
  oConverter := TsgcDocsConverter.Create(nil);
  try
    oConverter.Convert('contract.docx', 'contract.html');
    oConverter.Convert('contract.pdf', 'contract.txt');
    // one PNG per page, at 96 dpi
    oConverter.ConvertToImages('contract.pdf', 'pages', 96);
  finally
    oConverter.Free;
  end;
end;

MailMergeEach 为 JSON 数组中的每个订单写出一个 PDF。{#} 是记录编号,{Name} 是字段值。

uses
  SysUtils, Classes,
  sgcDocs_Types, sgcDocs_MailMerge, sgcDocs_Word;

procedure InvoicesFromJSON;
var
  oWord: TsgcDocsWordProcessor;
  oData: TsgcDocsMergeJSON;
  vCount: Integer;
begin
  oWord := TsgcDocsWordProcessor.Create(nil);
  oData := TsgcDocsMergeJSON.Create;
  try
    // a template made in Word: MERGEFIELD Name, MERGEFIELD Total \# ,0.00
    // and a table region from TableStart:Lines to TableEnd:Lines
    oWord.LoadFromFile('invoice_template.docx');
    // [{"Name": "Anna Lopez", "Total": 1250.5, "Lines": [...]}, ...]
    oData.LoadFromFile('orders.json');
    // one PDF per order: invoice_1_Anna Lopez.pdf, invoice_2_Ben Miller.pdf
    vCount := oWord.MailMergeEach(oData, 'invoice_{#}_{Name}.pdf');
    WriteLn(vCount, ' invoices written');
  finally
    oData.Free;
    oWord.Free;
  end;
end;

写入值,使用 LET 的公式,计算结果,并把工作簿保存为 XLSX 和 ODS 且打印为 PDF。

uses
  SysUtils, Classes,
  sgcDocs_Types, sgcDocs_Spreadsheet;

procedure CreateSales;
var
  oSheet: TsgcDocsSpreadsheet;
begin
  oSheet := TsgcDocsSpreadsheet.Create(nil);
  try
    oSheet.New;
    oSheet.Values['A1'] := 'Product';
    oSheet.Values['B1'] := 'Units';
    oSheet.Values['C1'] := 'Price';
    oSheet.Values['A2'] := 'Paper';
    oSheet.Values['B2'] := 12;
    oSheet.Values['C2'] := 4.5;
    oSheet.Values['A3'] := 'Toner';
    oSheet.Values['B3'] := 3;
    oSheet.Values['C3'] := 39.9;
    oSheet.Values['A4'] := 'Total';
    // a text that starts with = is a formula, LET and LAMBDA included
    oSheet.Values['C4'] := '=LET(t, SUMPRODUCT(B2:B3, C2:C3), ROUND(t, 2))';
    oSheet.Calculate;
    WriteLn('Total: ', oSheet.Text['C4']);
    oSheet.SaveToFile('sales.xlsx');
    oSheet.SaveToFile('sales.ods');
    WriteLn(oSheet.ExportToPDFFile('sales.pdf'), ' PDF page(s)');
  finally
    oSheet.Free;
  end;
end;

.NET 包 esegece.sgcDocs 保留了 Delphi 的类名。这个控制台程序填充模板,创建工作簿,把两个 PDF 文件合并为 PDF/A-2b 文件,并转换源文件。

using System;
using esegece.sgcDocs;
using esegece.sgcPDF;

static class Program
{
    static void Main()
    {
        // fill a DOCX template made in Word and export it to PDF
        using (var word = new TsgcDocsWordProcessor())
        {
            word.LoadFromFile("contract_template.docx");
            word.ReplaceAll("[CUSTOMER]", "Anna Lopez");
            word.SaveToFile("contract.docx");
            word.ExportToPDFFile("contract.pdf");
        }

        // a spreadsheet with a formula, saved as XLSX and printed to PDF
        using (var sheet = new TsgcDocsSpreadsheet())
        {
            sheet.New();
            sheet.SetValues("A1", "Units");
            sheet.SetValues("A2", 12);
            sheet.SetValues("A3", 30);
            sheet.SetFormulas("A4", "=SUM(A2:A3)");
            sheet.Calculate();
            Console.WriteLine("Total: " + sheet.Text("A4"));
            sheet.SaveToFile("units.xlsx");
            sheet.ExportToPDFFile("units.pdf");
        }

        // merge both PDF files and convert the result to PDF/A-2b
        using (var pdf = new TsgcDocsPDFProcessor())
        {
            pdf.LoadFromFile("contract.pdf");
            pdf.Merge("units.pdf");
            pdf.ConvertToPDFA(TsgcPDFALevel.paA2b);
            pdf.SaveToFile("contract_pack.pdf");
            Console.WriteLine(pdf.PageCount + " pages");
        }

        // one call conversions, the formats come from the file extensions
        using (var converter = new TsgcDocsConverter())
        {
            converter.Convert("contract.docx", "contract.md");
            converter.Convert("units.xlsx", "units.csv");
        }
    }
}

运行 sgcDocs 演示

Delphi 和 C++ Builder 演示随 sgcUI 试用版安装在 Demos\Docs 中。.NET 演示随 Registered 版 .NET 下载一同提供。Delphi 控制台演示只使用 RTL 和 sgc 单元,因此无需修改即可在 Windows 和 Linux64 上构建并运行。

WordCreate 和 WordConvert

一份带有标题、样式表格、列表、图像、页眉、带页码的页脚和脚注的文档,保存为 DOCX、PDF 和 PNG。WordConvert 加载任意文档并将其保存为所有其他格式。

MailMerge

带开关的合并域、IF 域和表格区域:由 CSV 生成信函,由 JSON 生成订单,输出为一个文档,或每条记录一个文件。

WordFindReplace

在正文、表格、页眉和页脚中搜索和替换,然后用密码设置只读保护。

SpreadsheetCreate 和 SpreadsheetConvert

一个销售表和一个贷款表,使用 LET、LAMBDA、XLOOKUP 和财务函数,带格式、柱形图和页面设置,保存为 XLSX、ODS、CSV、PDF 和 HTML。

PDFTools

HTML 转 PDF,合并、拆分、旋转,文本提取和搜索,PNG 页面,AES-256 加密,表单填写和展平,以及 PDF/A 转换和验证。

Barcodes 和 ZipArchive

全部 11 种条形码,输出为 PNG、SVG 以及绘制在 PDF 页面上。一个带条目元数据的 ZIP 压缩包,一个被拒绝的路径遍历压缩包,以及一个含 70,000 个条目的 ZIP64 压缩包。

DocumentConverter

14 种格式及其 63 个格式对的 CanConvert 矩阵,以及把任意文件转换为目标格式,PNG 和 SVG 输出页面图像。

ConversionServer

一个 REST 转换服务,提供 POST /convert、POST /merge、GET /formats 和 GET /health,每个请求一个转换器,并限制最大上传大小。

C++ Builder 和 .NET 演示

适用于 C++ Builder 13 的 DocumentConverter、MailMerge、PDFTools 和 WordCreate。适用于 .NET 8 的 11 个 C# 项目移植自 Delphi 演示,ConversionServer 是一个 ASP.NET Core 最小 API。

sgcDocs 包含在哪些版本中

sgcDocs 包含在 sgcUI Enterprise 和 All-Access 中,不作为单独的产品销售。它建立在 sgcUICore、sgcRichEdit、sgcGrid、sgcSpreadsheet、sgcCharts 和 sgcPDF 之上,这些都属于 sgcUI Enterprise,安装程序会随之一并安装。没有免费的 Community 版,.NET 包 esegece.sgcDocs 仅提供 Registered 版。

sgcUI Enterprise

包含所有 sgcUI 产品,其中有 sgcDocs 及其所依赖的引擎,起价 €699。

查看 Enterprise →

All-Access

包含 eSeGeCe 的所有产品,其中有 sgcUI Enterprise 和 sgcDocs。

查看 All-Access →

支持的编译器与平台

sgcDocs 中的组件

文档

TsgcDocsWordProcessor 和 TsgcDocsMailMerge。

电子表格

TsgcDocsSpreadsheet。

PDF、条形码和 ZIP

TsgcDocsPDFProcessor、TsgcDocsBarcode 和 TsgcDocsZipArchive。

转换

TsgcDocsConverter。

目标组件版本和平台
Delphi 7 至 13七个 sgcDocs 组件Win32,以及 Delphi XE2 起的 Win64
C++ Builder 2007 至 13相同的类生成的 .hpp 头文件和静态库
Linux64相同的单元,不含 VCL、FireMonkey 或 GDI 代码控制台程序、守护进程和 Web 服务器。需要 libz.so.1 以及文档所用的 TrueType 字体
.NETesegece.sgcDocs.NET Standard 2.0、.NET Framework 4.7.2、.NET 6、8、9 和 10
.NET 页面图像esegece.sgcUICore.Rendering仅在需要文档和工作表的 PNG 和 SVG 页面时添加

常见问题解答

不需要。sgcDocs 不需要 Microsoft Office、LibreOffice、COM,也不需要外部 DLL。所有读取器、写入器和渲染器都是 sgcUI 引擎的 Pascal 代码,或 .NET 包中的 C# 代码。

文档支持 DOCX、RTF、HTML、Markdown 和文本,电子表格支持 XLSX、ODS 和 CSV,另外还有 PDF 文件。输出还包括 PDF、PNG 和 SVG 页面,PNG、JPEG、BMP 和 TIFF 图像可转换为 PDF。PPTX、二进制 XLS 和 DOC 格式、ODT 读取、数据透视表、批注和修订以及 Office 文件加密不在此版本中。

可以。这些单元可编译为 Linux64,并在控制台程序和守护进程中运行。可执行文件需要 libz.so.1(每个发行版都会安装它)以及文档所用的 TrueType 字体,字体可安装在服务器上,也可用 AddFontFolder 从某个文件夹添加。

可以,这正是它的设计目的。组件不是线程安全的,因此请在处理请求的线程中创建该请求所需的组件,并在请求结束时释放。不同的实例可并行运行。ConversionServer 演示展示了一个完整的 REST 转换服务。

没有。sgcDocs 属于 sgcUI Enterprise 和 All-Access。.NET 包仅提供 Registered 版,不在 nuget.org 上发布。请使用 sgcUI 试用版进行评估。

包含。每个 sgcUI Enterprise 许可证都含完整源代码和 1 年更新。请参阅 sgcUI 价格页面。

sgcDocs 帮助

在线帮助

sgcUI 帮助:Delphi、C++ Builder 和 .NET,内容包括安装、支持的格式、入门、邮件合并、文档转换、Linux 上的字体以及服务器部署。

PDF 手册

Delphi、C++ Builder 和 .NET,涵盖所有 sgcUI 产品。

3,000+开发者
20+年
761+组件
30+API 集成
5平台
30 天退款保证不满意?可在购买后 30 天内申请全额退款。 查看退款政策

立即试用 sgcDocs

sgcUI 试用版包含 sgcDocs 和所有其他 sgcUI 产品。