將子書籤加入 PDF

向 PDF 新增子書籤簡介

在本文中，我們將探討如何使用 Aspose.PDF for Java 為 PDF 文件新增子書籤。子書籤是組織和瀏覽 PDF 文件內容的便捷方式，使用戶可以更輕鬆地找到文件中的特定部分或主題。

先決條件

在我們深入實施之前，請確保您具備以下先決條件：

您的系統上安裝了 Java 開發環境。
Aspose.PDF for Java 函式庫。您可以從以下位置下載：這裡.

設定環境

從提供的連結下載 Aspose.PDF for Java 函式庫。
將庫新增到您的 Java 專案中。

現在，讓我們開始建立一個新的 PDF 文件並逐步向其添加子書籤。

建立新的 PDF 文檔

首先，我們需要初始化 PDF 文件並向其添加頁面。這是開始的程式碼片段：

//初始化 PDF 文件
Document pdfDocument = new Document();

//將頁面新增至 PDF
pdfDocument.getPages().add();
pdfDocument.getPages().add();

在此範例中，我們建立了一個新的 PDF 文件並向其中新增了兩個頁面。

新增父親書籤

父書籤充當 PDF 文件中的主要部分或類別。讓我們創建一些父親書籤：

//創建父親書籤
OutlineItemCollection outline = pdfDocument.getOutlines();
OutlineItemCollection parentBookmark = new OutlineItemCollection(outline);
parentBookmark.setTitle("Parent Bookmark 1");
outline.add(parentBookmark);

parentBookmark = new OutlineItemCollection(outline);
parentBookmark.setTitle("Parent Bookmark 2");
outline.add(parentBookmark);

我們新增了兩個父書籤：「父親書籤 1」和「父親書籤 2」。

新增子書籤

現在，是時候將子書籤加入我們之前建立的父書籤中了。子書籤代表每個父書籤中的特定主題或子部分。您可以這樣做：

//將子書籤加到父親書籤 1
OutlineItemCollection childBookmark = new OutlineItemCollection(outline);
childBookmark.setTitle("Child Bookmark 1.1");
parentBookmark.add(childBookmark);

childBookmark = new OutlineItemCollection(outline);
childBookmark.setTitle("Child Bookmark 1.2");
parentBookmark.add(childBookmark);

//將子書籤加到父親書籤 2
childBookmark = new OutlineItemCollection(outline);
childBookmark.setTitle("Child Bookmark 2.1");
parentBookmark.add(childBookmark);

我們已將子書籤加入「父書籤 1」和「父親書籤 2」。

自訂書籤外觀

您可以透過更改書籤的文字和樣式來自訂書籤的外觀。此外，您可以將圖標添加到書籤以獲得更好的視覺表示。以下是如何執行此操作的範例：

//自訂書籤外觀
parentBookmark.setItalic(true);
childBookmark.setForegroundColor(Color.getGreen());
childBookmark.setIcon(OutlineItemCollection.getItalicIcon());

在此範例中，我們將父書籤設定為斜體，將子書籤的文字顏色變更為綠色，並在子書籤新增斜體圖示。

處理事件

書籤還可以有與其關聯的操作。例如，您可以新增在使用者點擊書籤時觸發的操作。以下是處理書籤點擊事件的方法：

//將操作加入書籤
GoToAction action = new GoToAction(pdfDocument.getPages().get_Item(1));
childBookmark.setAction(action);

在此程式碼中，我們為子書籤新增了「GoTo」操作，按一下該操作會將使用者帶到 PDF 的第二頁。

儲存 PDF

在添加所有必要的書籤並自訂其外觀和操作後，您可以儲存修改後的 PDF 文件：

//儲存 PDF 文件
pdfDocument.save("output.pdf");

帶有子書籤的 PDF 文件現已準備就緒。

完整的原始碼

以下是使用 Aspose.PDF for Java 將子書籤加入 PDF 文件的完整原始碼：

//初始化 PDF 文件
Document pdfDocument = new Document();

//將頁面新增至 PDF
pdfDocument.getPages().add();
pdfDocument.getPages().add();

//創建父親書籤
OutlineItemCollection outline = pdfDocument.getOutlines();
OutlineItemCollection parentBookmark = new OutlineItemCollection(outline);
parentBookmark.setTitle("Parent Bookmark 1");
outline.add(parentBookmark);

parentBookmark = new OutlineItemCollection(outline);
parentBookmark.setTitle("Parent Bookmark 2");
outline.add(parentBookmark);

//將子書籤加到父親書籤 1
OutlineItemCollection childBookmark = new OutlineItemCollection(outline);
childBookmark.setTitle("Child Bookmark 1.1");
parentBookmark.add(childBookmark);

childBookmark = new OutlineItemCollection(outline);
childBookmark.setTitle("Child Bookmark 1.2");
parentBookmark.add(childBookmark);

//將子書籤加到父親書籤 2
childBookmark = new OutlineItemCollection(outline);
childBookmark.setTitle("Child Bookmark 2.1");
parentBookmark.add(childBookmark);

//自訂書籤外觀
parentBookmark.setItalic(true);
childBookmark.setForegroundColor(Color.getGreen());
childBookmark.setIcon(OutlineItemCollection.getItalicIcon());

//將操作加入書籤
GoToAction action = new GoToAction(pdfDocument.getPages().get_Item(1));
childBookmark.setAction(action);

//儲存 PDF 文件
pdfDocument.save("output.pdf");

結論

使用 Aspose.PDF for Java 將子書籤新增至 PDF 是一項強大的功能，可增強文件的導覽和組織。透過遵循本文中概述的步驟，您可以建立帶有父書籤和子書籤的結構良好的 PDF、自訂其外觀，甚至添加操作以增強使用者體驗。

常見問題解答

如何下載 Java 版 Aspose.PDF？

您可以從網站下載 Aspose.PDF for Java這裡.

所有 PDF 檢視器都支援子書籤嗎？

是的，大多數現代 PDF 檢視器都支援子書籤，並提供增強的使用者瀏覽 PDF 文件的體驗。

我可以進一步自訂書籤的外觀嗎？

是的，您可以透過調整文字樣式、顏色和圖示來自訂書籤的外觀，以適合您的文件設計。

我還可以為書籤添加哪些其他操作？

除了「GoTo」操作之外，您還可以新增「URI」操作等操作來開啟 Web 鏈接，或新增「JavaScript」操作來在按一下書籤時執行自訂腳本。

Aspose.PDF for Java 適合商業專案嗎？

是的，Aspose.PDF for Java 適用於個人和商業項目，並且它提供了廣泛的 PDF 操作和生成功能。

在 PDF 文件中建立書籤將書籤設定為 PDF 頁面的開頭