Skip to content
DemoFAQ

PDF 生成模板编辑器

开源可视化 PDF 生成引擎,支持自定义模板,并提供面向开发者的 API,灵活构建文档生成流程。

查看 GitHub

Word 转 PDF — C ​

Word 转 PDF ​

概述 ​

ComPDF Conversion SDK 支持通过 CPDF_StartWordToPDF 将 Word 文档转换为 PDF 文件。您可以选择 PDF 书签的生成方式、指定输出的页面范围,并获取可能影响还原度的特性的诊断信息。

c
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 选项 ​

Word 转 PDF 只使用 CConvertOption 的以下字段:

字段类型默认含义
word_pdf_bookmark_modeCWordPdfBookmarkModee_CWordPdfBookmarkNone如何生成 PDF 书签(阅读器导航栏中的目录)
page_rangeschar[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。同一次转换中相同特性只报一次。
  • 转换本身失败时返回真实的错误码,优先于 95。
  • 缓冲区放不下完整诊断时返回 e_CErrOutOfMemory,不会截断。
  • diagnostics 传 NULL 时,存在上述特性仍会返回 95,但不提供诊断文本。
  • 授权不包含 Word 转换权限时,返回 e_CErrLicensePermissionDeny。

示例 ​

使用默认选项将 Word 文档转换为 PDF:

c
CConvertOption options = CPDF_CONVERT_OPTION_DEFAULT;

CSDKErrorCode code = CPDF_StartWordToPDF(
    CPDF_TEXT("input.docx"),
    CPDF_TEXT("path/output.pdf"),
    options,
    NULL,
    NULL);

按标题生成书签,并只输出部分页面:

c
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);

获取诊断信息和转换进度:

c
#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;
}