建立帶有標記文字的 PDF

介紹

在當今的數位時代，PDF 文件已成為共享和顯示內容的最受歡迎的格式之一。無論是商業報告、學術論文或使用手冊，PDF 無所不在！但優秀 PDF 與優秀 PDF 的區別在於可訪問性和結構。這是正確的！標籤的 PDF 使螢幕閱讀器和輔助技術更容易理解和瀏覽內容。你猜怎麼著？在本教學中，我將逐步引導您完成使用 Aspose.PDF for .NET 建立標記 PDF 的過程！

所以，拿起您最喜歡的飲料，坐下來，讓我們深入標籤的 PDF 的世界！

先決條件

在我們開始之前，您需要準備好一些東西：

  1. Visual Studio - 確保您的電腦上安裝了 Visual Studio。您可以使用任何支援 .NET 的版本。
  2. Aspose.PDF for .NET - 從下列位置下載最新版本的 Aspose.PDF for .NET網站。您也可以選擇免費試用來探索其功能。
  3. .NET Framework - 這些範例將為 .NET 建置。確保您的電腦上安裝了相容版本。
  4. C# 基礎知識 - 熟悉 C# 程式設計將在我們編寫一些程式碼時派上用場！

東西都齊全了嗎？偉大的！讓我們開始編碼吧！

導入包

現在我們已經解決了先決條件，讓我們繼續有趣的部分：導入必要的套件。要使用 Aspose.PDF，您肯定需要將該庫新增至您的專案。

建立一個新項目

首先，啟動 Visual Studio 並建立一個新的 C# 專案。

  1. 打開視覺工作室。
  2. 按一下“建立新專案”。
  3. 選擇“控制台應用程式 (.NET)”，然後按一下“下一步”。
  4. 為您的專案命名（例如，TaggedPdfExample）並設定其位置。
  5. 按一下“建立”。

新增 Aspose.PDF 參考

現在，讓我們加入 Aspose.PDF 庫：

  1. 在解決方案資源管理器中以滑鼠右鍵按一下您的專案。
  2. 選擇“管理 NuGet 套件”。
  3. 搜尋“Aspose.PDF”並安裝最新版本。

導入所需的命名空間

在主程式檔案的頂部（例如Program.cs），導入以下命名空間：

using Aspose.Pdf.LogicalStructure;
using Aspose.Pdf.Tagged;
using Aspose.Pdf.Text;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;

現在我們已經完成了所有設置，讓我們將程式碼分解為易於理解的部分，並逐步創建一個帶有標籤的 PDF！

第 1 步：定義文檔目錄

在開始編碼之前，讓我們先定義儲存 PDF 檔案的文檔目錄：

//文檔目錄的路徑。
string dataDir = "YOUR DOCUMENT DIRECTORY"; //將此更新為您的路徑

代替"YOUR DOCUMENT DIRECTORY"與您要儲存 PDF 的實際路徑。

第 2 步：建立 PDF 文檔

讓我們建立一個新的 PDF 文件實例。這就像繪製一張空白畫布，我們將在其中添加內容。

//建立 PDF 文件
Document document = new Document();

步驟 3：取得文件的標記內容

接下來，我們需要取得文件的標記內容。將標記內容視為使其可存取的基礎結構。操作方法如下：

//取得與 TaggedPdf 一起使用的內容
ITaggedContent taggedContent = document.TaggedContent;

步驟 4：設定文件的標題和語言

現在，讓我們設定文件的標題和語言。這對於可訪問性來說非常重要！

//設定文件的標題和語言
taggedContent.SetTitle("Tagged Pdf Document");
taggedContent.SetLanguage("en-US");

步驟 5：建立文字區塊級結構元素

這是我們創建內容的地方。我們將製作標題和段落，就像搭積木一樣！

步驟 5.1：建立標題元素

首先，讓我們建立一個標題元素：

//建立文字區塊級結構元素
HeaderElement headerElement = taggedContent.CreateHeaderElement();
headerElement.ActualText = "Heading 1";

步驟 5.2：建立段落元素

接下來，讓我們加入一些段落。我將為您添加幾個，但您可以根據您的需求進行自訂！

ParagraphElement paragraphElement1 = taggedContent.CreateParagraphElement();
paragraphElement1.ActualText = "test1";

ParagraphElement paragraphElement2 = taggedContent.CreateParagraphElement();
paragraphElement2.ActualText = "test 2";

ParagraphElement paragraphElement3 = taggedContent.CreateParagraphElement();
paragraphElement3.ActualText = "test 3";

ParagraphElement paragraphElement4 = taggedContent.CreateParagraphElement();
paragraphElement4.ActualText = "test 4";

ParagraphElement paragraphElement5 = taggedContent.CreateParagraphElement();
paragraphElement5.ActualText = "test 5";

ParagraphElement paragraphElement6 = taggedContent.CreateParagraphElement();
paragraphElement6.ActualText = "test 6";

ParagraphElement paragraphElement7 = taggedContent.CreateParagraphElement();
paragraphElement7.ActualText = "test 7";

步驟 6：儲存 PDF 文檔

最後，讓我們一起拯救這部傑作吧！以下是保存標籤的 PDF 的方法：

//儲存 PDF 文件
document.Save(dataDir + "PDFwithTaggedText.pdf");

您剛剛建立了一個帶有標籤的 PDF！

結論

一旦掌握了竅門，使用 Aspose.PDF for .NET 建立標籤的 PDF 就非常簡單！它使您的文件不僅易於使用，而且可供更廣泛的受眾使用。強調語義結構肯定會有回報，特別是如果您所在的行業內容可訪問性至關重要。

常見問題解答

什麼是標籤的 PDF？

帶有標籤的 PDF 包含結構化數據，使螢幕閱讀器和輔助技術更容易有效地導航內容。

我需要購買 Aspose.PDF 才能使用它嗎？

雖然您可以從免費試用開始，但長期使用需要許可證。您可以了解更多這裡.

我可以自訂 PDF 中的結構元素嗎？

絕對地！您可以根據您的要求操縱各種元素並創建複雜的結構。

Aspose.PDF 是否與所有 .NET 應用程式相容？

是的，Aspose.PDF 旨在跨各種 .NET 平台工作，包括 .NET Framework、.NET Core 等。

在哪裡可以找到對 Aspose.PDF 的支援？

您可以訪問Aspose 支援論壇對於您遇到的任何疑問或問題。

使用標記圖像建立 PDF 建立結構元素