PDF 生成模板编辑器
开源可视化 PDF 生成引擎,支持自定义模板,并提供面向开发者的 API,灵活构建文档生成流程。
ComPDF Conversion SDK 支持通过 CPDF_StartWordToPDF 将 Word 文档转换为 PDF 文件。您可以选择 PDF 书签的生成方式、指定输出的页面范围,并获取可能影响还原度的特性的诊断信息。
CSDKErrorCode CPDF_StartWordToPDF(
COMPDFKIT_STRING file_path,
COMPDFKIT_STRING output_path,
CConvertOption options,
CConvertCallback* callback,
char* diagnostics);| 参数 | 含义 |
|---|---|
file_path | 输入的 Word 文档路径 |
output_path | 输出的 PDF 路径 |
options | 转换选项,请从 CPDF_CONVERT_OPTION_DEFAULT 开始设置;Word 转 PDF 只使用 word_pdf_bookmark_mode 与 page_ranges,其他字段不生效 |
callback | 可选,用于获取进度和取消转换;不需要时传 NULL |
diagnostics | 可选,由调用方分配的缓冲区,大小为 CPDF_WORD_TO_PDF_DIAGNOSTICS_SIZE(8192 字节)。SDK 向其中写入 UTF-8 诊断文本,不分配也不释放;不需要诊断信息时传 NULL |
Word 转 PDF 只使用 CConvertOption 的以下字段:
| 字段 | 类型 | 默认 | 含义 |
|---|---|---|---|
word_pdf_bookmark_mode | CWordPdfBookmarkMode | e_CWordPdfBookmarkNone | 如何生成 PDF 书签(阅读器导航栏中的目录) |
page_ranges | char[256] | 空 | 指定输出的页码,如 "1-3,5,7-9";空表示输出所有页 |
CWordPdfBookmarkMode 的取值:
| 值 | 含义 |
|---|---|
e_CWordPdfBookmarkNone | 不生成书签 |
e_CWordPdfBookmarkHeadings | 每个标题(带大纲级别的段落)生成一个书签,按级别嵌套 |
e_CWordPdfBookmarkWordBookmarks | 每个 Word 书签生成一个书签,书签名与 Word 中一致 |
e_CErrUnsupportedFeature(95)。此时 PDF 通常仍会生成:诊断文本第一行 output=produced 表示已生成,output=not_produced 表示未生成完整 PDF。ruby:unsupported ruby layout。同一次转换中相同特性只报一次。e_CErrOutOfMemory,不会截断。diagnostics 传 NULL 时,存在上述特性仍会返回 95,但不提供诊断文本。e_CErrLicensePermissionDeny。使用默认选项将 Word 文档转换为 PDF:
CConvertOption options = CPDF_CONVERT_OPTION_DEFAULT;
CSDKErrorCode code = CPDF_StartWordToPDF(
CPDF_TEXT("input.docx"),
CPDF_TEXT("path/output.pdf"),
options,
NULL,
NULL);按标题生成书签,并只输出部分页面:
CConvertOption options = CPDF_CONVERT_OPTION_DEFAULT;
options.word_pdf_bookmark_mode = e_CWordPdfBookmarkHeadings;
strcpy(options.page_ranges, "1-3,5,7-9");
CSDKErrorCode code = CPDF_StartWordToPDF(
CPDF_TEXT("input.docx"),
CPDF_TEXT("path/output.pdf"),
options,
NULL,
NULL);获取诊断信息和转换进度:
#include <stdio.h>
static void Progress(int current_page_count, int total_page_count)
{
printf("progress: %d / %d\n", current_page_count, total_page_count);
}
char diagnostics[CPDF_WORD_TO_PDF_DIAGNOSTICS_SIZE] = {0};
CConvertOption options = CPDF_CONVERT_OPTION_DEFAULT;
options.word_pdf_bookmark_mode = e_CWordPdfBookmarkWordBookmarks;
CConvertCallback callback = {0};
callback.progress = Progress;
CSDKErrorCode code = CPDF_StartWordToPDF(
CPDF_TEXT("input.docx"),
CPDF_TEXT("path/output.pdf"),
options,
&callback,
diagnostics);
if (code == e_CErrUnsupportedFeature) {
// PDF 通常仍会生成。请查看诊断文本第一行:
// "output=produced" 或 "output=not_produced"。
printf("%s", diagnostics);
} else if (code != e_CErrSuccess) {
return code;
}