小白入门级-基于C#在Windows平台使用ComPDFKit 开发PDF阅读器

小白入门级-基于C#在Windows平台使用ComPDFKit 开发PDF阅读器

随着对处理 PDF 文档的需求不断攀升， 把ComPDFKit PDF 查看和编辑功能无缝融入您的 Windows 应用程序或系统中，将为您的用户带来非凡的体验。
我们将首先一同探索集成 ComPDFKit PDF SDK 所需的关键步骤，随后利用 ComPDFKit 构建出一个出色的 Windows PDF 阅读器器。无论您是想增强现有应用的功能，还是打造全新的 PDF 处理工具，本文都将为您提供清晰的指导，助您在 Windows 平台上实现卓越的 PDF 处理体验。让我们一同踏上这个令人兴奋的旅程吧！
在旅途开始之前，您需要进行试用申请获取许可密钥，除此之外还给您提供了产品介绍和开发文档：
免费试用申请：https://www.compdf.com/contact-sales
产品介绍：https://www.compdf.com/pdf-sdk
开发文档：https://www.compdf.com/guides/pdf-sdk/windows/make-a-program

首先，您需要下载Visual Studio 2017，或者更高版本，点击“创建新项目”

然后，选择WPF应用程序（.NET Framework）然后点击“下一步”。

配置项目：设置项目名称并选择存储程序的位置。例如，我们取项目名称为“ComPDFKit Demo”，使用.NET Framework 4.7.2作为编程框架，点击“创建”按钮，新项目将被创建。

您可以通过Nuget集成和两种方法可以添加ComPDFKit到您的项目中，您可以选择适合您需求的方法：

在解决方案资源管理器中，右键单击“引用”，点击“Manage NuGet Packeages…”。

搜索“ComPDFKit.NetFramework”，在nuget.org上找到这个软件包，这里要注意，同一个名称的安装包有很多，在选软件包时注意对比软件包图标是否和下图一致。

点击安装按钮，如下图

点击安装按钮后，会出现一个提示弹窗，点击确认即可继续安装

安装成功后，可以看到软件包图标右下角有一个绿色对勾标识

除了针对 nuget.org 上的包，您可以设置一个配置来指向本地包。这样在离线状态也能下载软件包了。
首先，您可以从试用申请通过后，获取到的SDK 包中找到 “ComPDFKit.NetFramework…nupkg” 文件。

将这个文件复制到您新建的项目文件夹下。

在与您的解决方案文件相同的目录中创建一个 “nuget.config” 文件（例如，“ComPDFKitDemo.sln”）。

在新建的"nuget.config" 文件中填入内容，请复制并粘贴以下内容的全部内容：

<?xml version="1.0" encoding="utf-8"?>
<configuration>
	<packageSources>
		<add key="ComPDFKitSource" value="path\to\directoryContainingNupkg" />
	</packageSources>
</configuration>

复制完成后，您需要修改上面代码中的value，将此时引用包含 “ComPDFKit.NetFramework…nupkg” 包的目录位置 — 例如，我上图例子中的路径”\Users\User-103\source\repos\ComPDFKit Demo“替换现有的value值。这里可以直接复制文件夹路径粘贴过来
现在保存文件，并关闭并重新打开解决方案以强制 Visual Studio 读取 NuGet 配置。

打开项目的解决方案，在解决方案资源管理器中，右键单击“引用”，然后点击“Manage NuGet Packages…”。这将会打开解决方案的 NuGet 程序包管理器。

在管理器的右侧，包源下拉窗口中，选择条目 ComPDFKitSource（或您决定的任何名称）。

这里要注意一下，在选择包源之前最好进入包源设置，取消勾选其他包源，这样可以避免在加载包源的时候收到干扰。

输入软件包名称，软件会出现在下方软件包栏。
这里要注意，同一个名称的软件包有很多，要认准下图软件包图标，选择下载

在右侧，面板中描述该程序包，点击“安装”按钮以安装该程序包。

点击安装按钮后，会出现提示弹窗，点击确认即可继续安装。

安装成功后，软件包图标右下角就会有一个绿色的对勾标识。

从您获取到的ComPDFKit中，将下面四个文件复制到您新建项目的ComPDFKit Demo文件夹下（若您新建项目是命名其他内容那就选在对应文件夹下）。
复制下图四个文件。

粘贴到您新建的文件夹内，完成后您的文件夹应该是这样。

然后进入visual studio，单击 "解决方案资源管理器 "菜单中的 "显示所有文件 "按钮。

将两个文件包含到项目中。

除此之外，下图两个文件也要进行包含到项目中的操作，操作步骤可见上图。

操作完成后，您可以看到。

然后新增引用。

将x64 x86文件夹里面的两个ComPDFKit.dll添加到引用管理器浏览模块。

添加成功后，您可以看到下图画面。

添加成功后，点击确认按钮，进入下一步操作。

然后将两个dll文件的属性均修改进行修改，先进入属性窗口。

将复制到输出目录的值修改为：如果较新则复制，如下图，设置完这一步，就完成了整个手动集成软件开发包的全部步骤啦。

您已经做好了环境准备工作，现在让我们修改示例代码来显示一个PDF文件吧！

在“MainWindow.xaml”和“MainWindow.xaml.cs”中，添加以下代码段。
“MainWindow.xaml”中添加下列代码

<Window x:Class="ComPDFKit_Demo.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
        xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
        xmlns:local="clr-namespace:ComPDFKit_Demo"
        mc:Ignorable="d"
        Title="MainWindow" Height="450" Width="800" UseLayoutRounding="True">
    <Grid>
        <Grid.RowDefinitions>
            <RowDefinition Height="*"/>
            <RowDefinition Height="52"/>
        </Grid.RowDefinitions>
        <Grid Name="PDFGrid" Grid.Row="0" />
        <Button Content="Open PDF" Grid.Row="1" HorizontalAlignment="Left" Margin="10" Click="OpenPDF_Click"/>
    </Grid>
</Window>

示例如下图：

“MainWindow.xaml.cs”中添加下列代码

using ComPDFKit.NativeMethod;
using ComPDFKit.PDFDocument;
using ComPDFKitViewer.PdfViewer;
using Microsoft.Win32;
using System.Windows;

namespace ComPDFKit_Demo
{
	public partial class MainWindow : Window
    {
        public MainWindow()
        {
            InitializeComponent();
            LicenseVerify();
        }
        
        bool LicenseVerify()
        {
            bool result = CPDFSDKVerifier.LoadNativeLibrary();
            if (!result)
            	return false;
            
            // You should fill in your key and secret into the string below. 
            string key = "Input your key instead of this string";
            string secret = "Input your secret instead of this string";
            LicenseErrorCode verifyResult = CPDFSDKVerifier.LicenseVerify(key, secret);
            if (verifyResult != LicenseErrorCode.LICENSE_ERR_SUCCESS)
                return false;
            
            return true;
        }

        private void OpenPDF_Click(object sender, RoutedEventArgs e)
        {
            // Get the path of a PDF file.
            var dlg = new OpenFileDialog();
            dlg.Filter = "PDF Files (*.pdf)|*.pdf";
            if (dlg.ShowDialog() == true)
            {
                // Use the PDF file path to open the document in CPDFViewer.
                CPDFViewer pdfViewer = new CPDFViewer();
                pdfViewer.InitDocument(dlg.FileName);
                if (pdfViewer.Document != null &&
                    pdfViewer.Document.ErrorType == CPDFDocumentError.CPDFDocumentErrorSuccess)
                {
                    pdfViewer.Load();
                    PDFGrid.Children.Add(pdfViewer);
                }
            }
        }
    }
}

示例如图：

这里要注意，这里需要通过开头提到的试用链接中获得，试用申请通过后，官方会免费给到您试用Demo和许可密钥。

打开上图xml文件，将密钥替换掉代码中key和secret的值。

到这里，我们已经搭建好环境也修改好示例代码啦，只需要点击启动按钮就能查看代码运行效果啦。