【亲测免费】 PdfiumViewer 开源PDF查看器项目教程

1. 项目介绍

PdfiumViewer 是一个基于 PDFium 项目构建的 PDF 查看器组件。它为 WinForms 应用程序提供了一组工具，用于处理和显示 PDF 文件。主要组件包括：

• PdfDocument: 基础类，用于渲染 PDF 文档。
• PdfRenderer: 一个 WinForms 控件，可以渲染 PdfDocument。
• PdfiumViewer: 包含 PdfRenderer 的 WinForms 控件，添加了保存或打印 PDF 的工具栏。

此库已在 Windows XP 和 Windows 8 上测试并兼容。但请注意，支持 V8 的原生 PDFium 库不支持 Windows XP。

2. 项目快速启动

要开始使用 PdfiumViewer，您需要按照以下步骤操作：

1. 安装 NuGet 包管理器扩展（如果您还没安装的话）。

2. 在 Visual Studio 中打开您的项目，然后在 Package Manager Console 中输入以下命令来安装 PdfiumViewer:

   PM> Install-Package PdfiumViewer
   

3. 添加控件到窗体：从 Toolbox 中找到并拖动 PdfiumViewer 到你的 WinForms 窗体上。

4. 加载 PDF 文件示例：

   using PdfiumViewer;
   
   // 初始化 PdfiumViewer 控件
   var pdfViewer = new PdfiumViewer.PdfiumViewer();
   
   // 加载 PDF 文件
   var filePath = "path_to_your_pdf_file.pdf";
   using (var document = PdfDocument.Load(filePath))
   {
       pdfViewer.Document = document;
   }
   

3. 应用案例和最佳实践

• 缩放和平移：默认情况下，PdfiumViewer 提供了缩放和平移功能。您可以允许用户通过鼠标滚轮或键盘快捷键进行操作。
• 事件处理：利用 PdfiumViewer 的事件（如 PageChanging 或 MouseClick），可实现自定义交互功能，比如添加书签或高亮文本。
• 性能优化：若处理大量文件，建议预加载 PDF 文档到内存中，避免频繁的磁盘读取。

4. 典型生态项目

虽然 PdfiumViewer 主要是 WinForms 应用的解决方案，但也有其相关的生态项目，例如：

• PdfiumViewer.NetCore.Wpf：这是 PdfiumViewer 的 .NET Core 和 .NET 6 的 WPF 版本。

• PdfiumBuild：自动化构建 PDFium 库的项目，用于生成特定版本的 PDFium 库。

如有任何疑问或遇到问题，可以在 Github 上的 PdfiumViewer issues 页面 寻求帮助和支持。