using IronPdf; // Disable local disk access or cross-origin requests Installation.EnableWebSecurity = true; // Instantiate Renderer var renderer = new ChromePdfRenderer(); // Create a PDF from a HTML string using C# var pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1>"); // Export to a file or Stream pdf.SaveAs("output.pdf"); // Advanced Example with HTML Assets // Load external html assets: Images, CSS and JavaScript. // An optional BasePath 'C:\site\assets\' is set as the file location to load assets from var myAdvancedPdf = renderer.RenderHtmlAsPdf("<img src='icons/iron.png'>", @"C:\site\assets\"); myAdvancedPdf.SaveAs("html-with-assets.pdf");

PDF 工具

如何在 C++ 中将 HTML 转换为 PDF

Curtis Chau

已更新:七月 28, 2025

将 HTML 文件或内容转换为 PDF 页面是一项在许多应用程序中都很有价值的功能。在 C++ 中，从头开始构建一个应用程序来生成 HTML 到 PDF 格式的文件可能相当繁琐。在本文中，我们将探讨如何使用 wkhtmltopdf 库在 C++ 中将 HTML 转换为 PDF。

WKHTMLTOPDF 库

wkhtmltopdf 是一个开源命令行工具，可以无缝地将 HTML 纯文本页面转换为高质量的 PDF 文档。通过在 C++ 程序中利用其功能，我们可以轻松地将 HTML 字符串内容转换为 PDF 格式。让我们深入了解使用 wkhtmltopdf 库在 C++ 中逐步将 HTML 页面转换为 PDF 的过程。

前提条件

要在 C++ 中创建一个 HTML 到 PDF 文件转换器，请确保满足以下先决条件：

在您的系统上安装诸如 GCC 或 Clang 的 C++ 编译器。
安装 wkhtmltopdf 库。您可以从官方的 wkhtmltopdf 网站下载最新版本并根据您的操作系统说明进行安装。
具备 C++ 编程的基础知识。

在 Code::Blocks 中创建一个 C++ HtmltoPdf 项目

要在 Code::Blocks 中创建一个 C++ PDF 转换项目，请按照以下步骤操作：

打开 Code::Blocks IDE。
转到"文件"菜单，选择"新建"，然后选择"项目"以打开新建项目向导。
在新建项目向导中，选择"控制台应用程序"。
选择 C++ 语言。
设置项目标题和您要保存的位置。点击"下一步"继续。
选择适当的 C++ 编译器和构建目标，例如调试或发布。点击"完成"创建项目。

设置搜索目录

要确保 Code::Blocks 能够找到必要的头文件，我们需要设置搜索目录：

点击菜单栏中的"项目"菜单，选择"构建选项"。确保选择"调试"。
在"构建选项"对话框中，选择"搜索目录"选项卡。
在"编译器"选项卡下，点击"添加"按钮。
浏览到 wkhtmltox 头文件所在的目录（例如：C:\Program Files\wkhtmltopdf\include），并选择它。
最后，点击"确定"关闭对话框。

如何在 C++ 中将 HTML 转换为 PDF：图 1 - 搜索目录

链接库

要链接 wkhtmltox 库，请按照以下步骤操作：

再次点击菜单栏中的"项目"菜单，选择"构建选项"。确保选择"调试"。
在"构建选项"对话框中，选择"链接器设置"选项卡。
在"链接库"选项卡下，点击"添加"按钮。
浏览到 wkhtmltox 库文件所在的目录（例如：C:\Program Files\wkhtmltopdf\lib），并选择适当的库文件。
点击"打开"将库添加到您的项目。
最后，点击"确定"以关闭对话框。

在 C++ 中将 HTML 转换为 PDF：图 2 - 链接库

用 C# 将 HTML 轻松转换为 PDF 的步骤

步骤 1：包含将 HTML 文件转换到 PDF 的库

首先，在您的 C++ 程序中包含必要的头文件以使用 wkhtmltopdf 库的功能。在 main.cpp 源代码文件的开头包含以下头文件，如以下示例所示：

#include <iostream>
#include <fstream>
#include <string>
#include <wkhtmltox/pdf.h>

#include <iostream>
#include <fstream>
#include <string>
#include <wkhtmltox/pdf.h>

C++

步骤 2：初始化转换器

要将 HTML 转换为 PDF，我们需要初始化 wkhtmltopdf 转换器。代码如下

// Initialize the wkhtmltopdf library
wkhtmltopdf_init(false);

// Create global settings object
wkhtmltopdf_global_settings* gs = wkhtmltopdf_create_global_settings();

// Create object settings object
wkhtmltopdf_object_settings* os = wkhtmltopdf_create_object_settings();

// Create the PDF converter with global settings
wkhtmltopdf_converter* converter = wkhtmltopdf_create_converter(gs);

// Initialize the wkhtmltopdf library
wkhtmltopdf_init(false);

// Create global settings object
wkhtmltopdf_global_settings* gs = wkhtmltopdf_create_global_settings();

// Create object settings object
wkhtmltopdf_object_settings* os = wkhtmltopdf_create_object_settings();

// Create the PDF converter with global settings
wkhtmltopdf_converter* converter = wkhtmltopdf_create_converter(gs);

C++

步骤 3：设置 HTML 内容

现在，让我们提供需要转换为 PDF 的 HTML 内容。您可以加载一个 HTML 文件或直接提供字符串。

std::string htmlString = "<html><body><h1>Hello, World!</h1></body></html>";

// Add the HTML content to the converter
wkhtmltopdf_add_object(converter, os, htmlString.c_str());

std::string htmlString = "<html><body><h1>Hello, World!</h1></body></html>";

// Add the HTML content to the converter
wkhtmltopdf_add_object(converter, os, htmlString.c_str());

C++

步骤 4：将 HTML 转换为 PDF

准备好转换器和 HTML 内容后，我们可以继续将 HTML 转换为 PDF 文件。使用以下代码段：

// Perform the actual conversion
if (!wkhtmltopdf_convert(converter)) {
    std::cerr << "Conversion failed!" << std::endl;
}

// Perform the actual conversion
if (!wkhtmltopdf_convert(converter)) {
    std::cerr << "Conversion failed!" << std::endl;
}

C++

步骤 5：获取内存缓冲区作为输出

使用 wkhtmltopdf_get_output 函数，我们可以获取现有的 PDF 数据作为内存缓冲区流。它还返回 PDF 的长度。以下示例将执行此任务：

// Retrieve the PDF data in memory buffer
const unsigned char* pdfData;
int pdfLength = wkhtmltopdf_get_output(converter, &pdfData);

// Retrieve the PDF data in memory buffer
const unsigned char* pdfData;
int pdfLength = wkhtmltopdf_get_output(converter, &pdfData);

C++

步骤 6：保存 PDF 文件

转换完成后，我们需要将生成的 PDF 文件保存到磁盘。指定您要保存 PDF 的文件路径。然后使用输出文件流，以二进制模式打开文件并将 pdfData 写入其中。最后，关闭文件：

const char* outputPath = "file.pdf";
std::ofstream outputFile(outputPath, std::ios::binary);

// Write the PDF data to the file
outputFile.write(reinterpret_cast<const char*>(pdfData), pdfLength);
outputFile.close();

const char* outputPath = "file.pdf";
std::ofstream outputFile(outputPath, std::ios::binary);

// Write the PDF data to the file
outputFile.write(reinterpret_cast<const char*>(pdfData), pdfLength);
outputFile.close();

C++

步骤 7：清理

在将 HTML 转换为 PDF 后，必须清理 wkhtmltopdf 分配的资源：

// Clean up the converter and settings
wkhtmltopdf_destroy_converter(converter);
wkhtmltopdf_destroy_object_settings(os);
wkhtmltopdf_destroy_global_settings(gs);

// Deinitialize the wkhtmltopdf library
wkhtmltopdf_deinit();

std::cout << "PDF saved successfully." << std::endl;

// Clean up the converter and settings
wkhtmltopdf_destroy_converter(converter);
wkhtmltopdf_destroy_object_settings(os);
wkhtmltopdf_destroy_global_settings(gs);

// Deinitialize the wkhtmltopdf library
wkhtmltopdf_deinit();

std::cout << "PDF saved successfully." << std::endl;

C++

步骤 8：执行代码并生成 PDF 文件

现在，构建项目并使用 F9 执行代码。输出将在项目文件夹中生成并保存。生成的 PDF 如下：

如何在C++中将HTML转换为PDF：图3 - PDF输出

HTML 文件到 PDF 文件在 C#

IronPDF。

IronPDF HTML 到 PDF 转换库是一个强大的 .NET 和 .NET Core C# 库，允许开发人员轻松地从 HTML 内容生成 PDF 文档。 IronPDF HTML 到 PDF 转换库是一个强大的 .NET 和 .NET Core C# 库，允许开发人员轻松地从 HTML 内容生成 PDF 文档。

它提供了一个简单且直观的 API，使将 HTML 网页转换为 PDF 的过程变得简单，成为各种应用程序和使用情况的热门选择。它不仅支持简单 HTML 文档的转换，还支持带有 CSS 样式、JavaScript 交互甚至动态内容的复杂网页。此外，您可以开发不同的 PDF 转换器，快速访问其转换方法。

以下是使用 IronPDF 在 C# 中将 HTML 字符串转换为 PDF 的代码示例：

using IronPdf;

// Instantiate Renderer
var renderer = new ChromePdfRenderer();

// Create PDF content from an HTML string using C#
var pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1>");

// Export to a file or Stream
pdf.SaveAs("output.pdf");

using IronPdf;

// Instantiate Renderer
var renderer = new ChromePdfRenderer();

// Create PDF content from an HTML string using C#
var pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1>");

// Export to a file or Stream
pdf.SaveAs("output.pdf");

$vbLabelText $csharpLabel

这是使用 IronPDF 在 C# 中将 HTML 字符串转换为 PDF 的代码示例：

如何在 C++ 中将 HTML 转换为 PDF：图 4 - IronPDF 输出

有关如何将不同 HTML 文件、网页 URL 和图像转换为 PDF 的更多详细信息，请访问此 HTML 到 PDF 代码示例。

有关如何将不同的 HTML 文件、网页 URL 和图像转换为 PDF 的更多详细信息，请访问此 HTML 到 PDF 代码示例。其直观的 API 和广泛的功能集使其成为需要在 C# 项目中转换 HTML 到 PDF 的开发人员的宝贵工具。其直观的 API 和广泛的功能集使其成为需要在 C# 项目中转换 HTML 到 PDF 的开发人员的重要工具。

IronPDF 在开发用途上是免费的，但商业使用需要获得许可。它还提供IronPDF完整功能的免费试用供商业使用，以测试其完整功能。它还为商业用途提供 IronPDF 完整功能的免费试用，以测试其完整的功能。