小白入門級-基于C#在Windows平臺使用ComPDFKit 開發(fā)PDF閱讀器

前言

隨著對處理 PDF 文檔的需求不斷攀升窗看， 把ComPDFKit PDF 查看和編輯功能無縫融入您的 Windows 應(yīng)用程序或系統(tǒng)中，將為您的用戶帶來非凡的體驗倦炒。

我們將首先一同探索集成 ComPDFKit PDF SDK 所需的關(guān)鍵步驟显沈，隨后利用 ComPDFKit 構(gòu)建出一個出色的 Windows PDF 閱讀器器。無論您是想增強現(xiàn)有應(yīng)用的功能逢唤，還是打造全新的 PDF 處理工具拉讯，本文都將為您提供清晰的指導(dǎo)，助您在 Windows 平臺上實現(xiàn)卓越的 PDF 處理體驗鳖藕。讓我們一同踏上這個令人興奮的旅程吧魔慷！

在旅途開始之前，您需要進行試用申請獲取許可密鑰著恩，除此之外還給您提供了產(chǎn)品介紹和開發(fā)文檔：

試用申請：Contact Sales | ComPDFKit

產(chǎn)品介紹：All Platforms & Fast Setup | ComPDFKit

開發(fā)文檔：Windows PDF Library—Viewer, Annotations, Forms, Security, and More | ComPDFKit | ComPDFKit

步驟1：搭建環(huán)境

首先院尔，您需要下載Visual Studio 2017蜻展，或者更高版本，點擊“創(chuàng)建新項目”

image.png

然后邀摆，選擇WPF應(yīng)用程序（.NET Framework）然后點擊“下一步”纵顾。

image.png

配置項目：設(shè)置項目名稱并選擇存儲程序的位置。例如隧熙，我們?nèi)№椖棵Q為“ComPDFKit Demo”片挂，使用.NET Framework 4.7.2作為編程框架幻林，點擊“創(chuàng)建”按鈕贞盯，新項目將被創(chuàng)建。

image.png

步驟2：軟件開發(fā)包集成

您可以通過Nuget集成和兩種方法可以添加ComPDFKit到您的項目中沪饺，您可以選擇適合您需求的方法：

方法1：通過NuGet集成

1.1通過NuGet集成-在線集成

在解決方案資源管理器中躏敢，右鍵單擊“引用”，點擊“Manage NuGet Packeages…”整葡。

image.png

搜索“ComPDFKit.NetFramework”件余，在nuget.org上找到這個軟件包，這里要注意遭居，同一個名稱的安裝包有很多啼器，在選軟件包時注意對比軟件包圖標(biāo)是否和下圖一致。

image.png

點擊安裝按鈕俱萍，如下圖

image.png

點擊安裝按鈕后端壳，會出現(xiàn)一個提示彈窗，點擊確認即可繼續(xù)安裝

image.png

安裝成功后枪蘑，可以看到軟件包圖標(biāo)右下角有一個綠色對勾標(biāo)識

image.png

1.2通過NuGet集成-離線集成

除了針對 nuget.org 上的包损谦，您可以設(shè)置一個配置來指向本地包。這樣在離線狀態(tài)也能下載軟件包了岳颇。

首先照捡，您可以從試用申請通過后，獲取到的SDK 包中找到 "ComPDFKit.NetFramework....nupkg" 文件话侧。

image.png

將這個文件復(fù)制到您新建的項目文件夾下栗精。

image.png

在與您的解決方案文件相同的目錄中創(chuàng)建一個 "nuget.config" 文件（例如，"ComPDFKitDemo.sln"）瞻鹏。

image.png

在新建的"nuget.config" 文件中填入內(nèi)容悲立，請復(fù)制并粘貼以下內(nèi)容的全部內(nèi)容：

<?xml version="1.0" encoding="utf-8"?>

<configuration>

<packageSources>

<add key="ComPDFKitSource" value="path\to\directoryContainingNupkg" />

</packageSources>

</configuration>

復(fù)制完成后，您需要修改上面代碼中的value乙漓，將此時引用包含 "ComPDFKit.NetFramework....nupkg" 包的目錄位置 — 例如级历，我上圖例子中的路徑”\Users\User-103\source\repos\ComPDFKit Demo“替換現(xiàn)有的value值。這里可以直接復(fù)制文件夾路徑粘貼過來

現(xiàn)在保存文件叭披，并關(guān)閉并重新打開解決方案以強制 Visual Studio 讀取 NuGet 配置寥殖。

image.png

打開項目的解決方案玩讳，在解決方案資源管理器中，右鍵單擊“引用”嚼贡，然后點擊“Manage NuGet Packages...”熏纯。這將會打開解決方案的 NuGet 程序包管理器。

image.png

在管理器的右側(cè)粤策，包源下拉窗口中樟澜，選擇條目 ComPDFKitSource（或您決定的任何名稱）。

image.png

這里要注意一下叮盘，在選擇包源之前最好進入包源設(shè)置秩贰，取消勾選其他包源，這樣可以避免在加載包源的時候收到干擾柔吼。

image.png

輸入軟件包名稱伍纫，軟件會出現(xiàn)在下方軟件包欄狈涮。

這里要注意，同一個名稱的軟件包有很多，要認準(zhǔn)下圖軟件包圖標(biāo)矾兜，選擇下載

image.png

在右側(cè)悍募，面板中描述該程序包兑巾，點擊“安裝”按鈕以安裝該程序包狮鸭。

image.png

點擊安裝按鈕后，會出現(xiàn)提示彈窗牌柄，點擊確認即可繼續(xù)安裝畸悬。

image.png

安裝成功后，軟件包圖標(biāo)右下角就會有一個綠色的對勾標(biāo)識友鼻。

image.png

方法2：手動集成軟件開發(fā)包-適用于離線狀態(tài)

從您獲取到的ComPDFKit中傻昙，將下面四個文件復(fù)制到您新建項目的ComPDFKit Demo文件夾下（若您新建項目是命名其他內(nèi)容那就選在對應(yīng)文件夾下）。

復(fù)制下圖四個文件彩扔。

image.png

粘貼到您新建的文件夾內(nèi)妆档，完成后您的文件夾應(yīng)該是這樣。

image.png

然后進入visual studio虫碉，單擊 "解決方案資源管理器 "菜單中的 "顯示所有文件 "按鈕贾惦。

image.png

將兩個文件包含到項目中。

image.png

除此之外敦捧，下圖兩個文件也要進行包含到項目中的操作须板，操作步驟可見上圖。

image.png

操作完成后兢卵，您可以看到习瑰。

image.png

然后新增引用。

image.png

將x64 x86文件夾里面的兩個ComPDFKit.dll添加到引用管理器瀏覽模塊秽荤。

image.png

添加成功后甜奄，您可以看到下圖畫面柠横。

image.png

添加成功后，點擊確認按鈕课兄，進入下一步操作牍氛。

image.png

然后將兩個dll文件的屬性均修改進行修改，先進入屬性窗口烟阐。

image.png

將復(fù)制到輸出目錄的值修改為：如果較新則復(fù)制搬俊，如下圖，設(shè)置完這一步蜒茄，就完成了整個手動集成軟件開發(fā)包的全部步驟啦唉擂。

image.png

步驟3：代碼寫入

您已經(jīng)做好了環(huán)境準(zhǔn)備工作，現(xiàn)在讓我們修改示例代碼來顯示一個PDF文件吧扩淀！

1.示例代碼修改

在“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>

示例如下圖：

image.png

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

}

}

}

}

}

示例如圖：

image.png

這里要注意驻谆，這里需要通過開頭提到的試用鏈接中獲得，試用申請通過后庆聘，官方會免費給到您試用Demo和許可密鑰胜臊。

image.png

打開上圖xml文件，將密鑰替換掉代碼中key和secret的值伙判。

image.png

2.代碼顯示

到這里象对，我們已經(jīng)搭建好環(huán)境也修改好示例代碼啦，只需要點擊啟動按鈕就能查看代碼運行效果啦宴抚。

image.png

總結(jié)

只需三個簡單步驟勒魔，您就可以輕松集成全新的應(yīng)用程序。然而菇曲，ComPDFKit的實際功能遠不僅限于此冠绢。除了提供簡便的集成，它還擁有廣泛的PDF功能常潮，包括閱讀弟胀、導(dǎo)航、注釋喊式、格式轉(zhuǎn)換孵户、表單處理、安全保護岔留、文檔編輯以及頁面編輯等夏哭。這款PDF SDK具備高度的界面定制化能力，您可以根據(jù)個人需求隨意調(diào)整軟件的風(fēng)格献联。當(dāng)然竖配，這僅僅是功能的一部分厕吉。

如果您渴望體驗更多的強大功能，現(xiàn)在就申請試用吧械念！我們將為您提供詳盡的技術(shù)文檔和試用Demo头朱，讓您深入了解ComPDFKit所能帶來的無限可能。期待與您的合作龄减！