Jak dodawać zakładki PDF i spis treści w Javie

Co jest potrzebne przed rozpoczęciem?

Przed wdrożeniem zakładek PDF potwierdź, że IronPDF jest skonfigurowany w twoim projekcie Java. Biblioteka wymaga Java 8 lub nowszego i integruje się przez Maven lub Gradle. Dodaj zależność IronPDF do pliku budowy projektu. Dla szczegółowych instrukcji dotyczących konfiguracji, zobacz Omówienie rozpoczęcia.

Ważny klucz licencyjny jest wymagany do użytku deweloperskiego i produkcyjnego. Ustaw klucz licencyjny na początku aplikacji przed wywołaniem jakichkolwiek metod IronPDF. Aby uzyskać informacje o opcjach licencyjnych, odwiedź przewodnik licencyjny.

Jak dodać kontury i zakładki do PDF?

Poniższe przykłady wykorzystują ten przykładowy PDF, aby zademonstrować tworzenie konturów i zakładek. Proces obejmuje załadowanie istniejącego dokumentu PDF i użycie BookmarkManager IronPDF do dodawania punktów nawigacyjnych w całym dokumencie.

//:path=/static-assets/ironpdf-java/content-code-examples/how-to/bookmarks/single-layer.java
import java.io.IOException;
import java.nio.file.Path;
import com.ironsoftware.ironpdf.License;
import com.ironsoftware.ironpdf.PdfDocument;
import com.ironsoftware.ironpdf.bookmark.BookmarkManager;

public class Main {
    public static void main(String[] args) throws IOException {
        // Set the license key for IronPDF
        License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

        // Load the PDF file
        PdfDocument pdf = PdfDocument.fromFile(Path.of("NovelSample.pdf"));

        // Get BookmarkManager object to manage bookmarks
        BookmarkManager bookmarks = pdf.getBookmark();

        // Add bookmarks at the end of the bookmark collection
        bookmarks.addBookMarkAtEnd("Title Page", 0);
        bookmarks.addBookMarkAtEnd("Table of Contents", 1);
        bookmarks.addBookMarkAtEnd("Dedication Page", 2);
        bookmarks.addBookMarkAtEnd("First Page", 3);
        bookmarks.addBookMarkAtStart("Page 4", 6);

        // Save the modified PDF with bookmarks
        pdf.saveAs(Path.of("bookmarked.pdf"));
    }
}

//:path=/static-assets/ironpdf-java/content-code-examples/how-to/bookmarks/single-layer.java
import java.io.IOException;
import java.nio.file.Path;
import com.ironsoftware.ironpdf.License;
import com.ironsoftware.ironpdf.PdfDocument;
import com.ironsoftware.ironpdf.bookmark.BookmarkManager;

public class Main {
    public static void main(String[] args) throws IOException {
        // Set the license key for IronPDF
        License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

        // Load the PDF file
        PdfDocument pdf = PdfDocument.fromFile(Path.of("NovelSample.pdf"));

        // Get BookmarkManager object to manage bookmarks
        BookmarkManager bookmarks = pdf.getBookmark();

        // Add bookmarks at the end of the bookmark collection
        bookmarks.addBookMarkAtEnd("Title Page", 0);
        bookmarks.addBookMarkAtEnd("Table of Contents", 1);
        bookmarks.addBookMarkAtEnd("Dedication Page", 2);
        bookmarks.addBookMarkAtEnd("First Page", 3);
        bookmarks.addBookMarkAtStart("Page 4", 6);

        // Save the modified PDF with bookmarks
        pdf.saveAs(Path.of("bookmarked.pdf"));
    }
}

Jak utworzyć kilka warstw zakładek?

Zagnieżdżone zakładki są odpowiednim wyborem dla dokumentacji technicznej, raportów badawczych lub jakiegokolwiek dokumentu wielorozdziałowego, gdzie czytelnicy muszą nawigować nie tylko do rozdziałów, ale także do podsekcji w ramach tych rozdziałów. Rozpocznij od tych samych płaskich zakładek, które utworzyłeś w poprzedniej sekcji, a następnie użyj insertBookmark, aby dodawać wpisy na nowych warstwach.

Metoda insertBookmark przyjmuje cztery parametry: nazwę zakładki, indeks docelowej strony, nazwę zakładki rodzicielskiej i nazwę poprzedniej zakładki rodzeństwa. Przekazanie nazwy zakładki rodzica tworzy zagnieżdżony pod nią wpis podrzędny. Ustawienie parametru rodzeństwa na null plasuje nowy wpis jako pierwsze dziecko tego rodzica.

//:path=/static-assets/ironpdf-java/content-code-examples/how-to/bookmarks/multi-layer.java
import java.io.IOException;
import java.nio.file.Path;
import com.ironsoftware.ironpdf.License;
import com.ironsoftware.ironpdf.PdfDocument;
import com.ironsoftware.ironpdf.bookmark.BookmarkManager;

public class Main {
    public static void main(String[] args) throws IOException {
        // Set the license key
        License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

        // Load the PDF file
        PdfDocument pdf = PdfDocument.fromFile(Path.of("NovelSample.pdf"));

        // Get BookmarkManager object
        BookmarkManager bookmarks = pdf.getBookmark();

        // Add top-level bookmarks at the end
        bookmarks.addBookMarkAtEnd("Title Page", 0);
        bookmarks.addBookMarkAtEnd("Table of Contents", 1);
        bookmarks.addBookMarkAtEnd("Dedication", 2);

        // Insert second-layer bookmarks as children of existing entries
        bookmarks.insertBookmark("First Page", 3, "Table of Contents", null);
        bookmarks.insertBookmark("Second Page", 4, "Table of Contents", "First Page");
        bookmarks.insertBookmark("End of Sample", 7, "Title Page", null);
        bookmarks.insertBookmark("Fourth page", 6, "Table of Contents", "Second Page");

        // Save the modified PDF with nested bookmarks
        pdf.saveAs(Path.of("multiLayer.pdf"));
    }
}

//:path=/static-assets/ironpdf-java/content-code-examples/how-to/bookmarks/multi-layer.java
import java.io.IOException;
import java.nio.file.Path;
import com.ironsoftware.ironpdf.License;
import com.ironsoftware.ironpdf.PdfDocument;
import com.ironsoftware.ironpdf.bookmark.BookmarkManager;

public class Main {
    public static void main(String[] args) throws IOException {
        // Set the license key
        License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

        // Load the PDF file
        PdfDocument pdf = PdfDocument.fromFile(Path.of("NovelSample.pdf"));

        // Get BookmarkManager object
        BookmarkManager bookmarks = pdf.getBookmark();

        // Add top-level bookmarks at the end
        bookmarks.addBookMarkAtEnd("Title Page", 0);
        bookmarks.addBookMarkAtEnd("Table of Contents", 1);
        bookmarks.addBookMarkAtEnd("Dedication", 2);

        // Insert second-layer bookmarks as children of existing entries
        bookmarks.insertBookmark("First Page", 3, "Table of Contents", null);
        bookmarks.insertBookmark("Second Page", 4, "Table of Contents", "First Page");
        bookmarks.insertBookmark("End of Sample", 7, "Title Page", null);
        bookmarks.insertBookmark("Fourth page", 6, "Table of Contents", "Second Page");

        // Save the modified PDF with nested bookmarks
        pdf.saveAs(Path.of("multiLayer.pdf"));
    }
}

JAVA

PDF powyżej pokazuje strukturę drzewa zakładek utworzonych przez insertBookmark. Rozwiń panel konspektu, aby zweryfikować, jak każdy wpis dziecięcy jest zagnieżdżony pod swoim rodzicem. To warstwowe podejście pasuje do raportów z rozdziałami, podrozdziałami i załącznikami.

---

Moją ulubioną biblioteką tego typu jest IronPDF. Umożliwia ona szybkie i efektywne manipulowanie plikami PDF. Posiada także wiele cennych funkcji, takich jak eksport do formatu PDF/A i cyfrowe podpisywanie dokumentów PDF.

Milan Jovanovic

Microsoft MVP

Zobacz studium przypadku

IronOCR pozwala nam oszczędzić 40 000 USD rocznie na ręcznym przetwarzaniu, jednocześnie zwiększając produktywność i uwalniając zasoby do zadań o wysokim wpływie. Gorąco polecam.

Brent Matzelle

Dyrektor technologiczny, OPYN

Zobacz studium przypadku

IronSuite odgrywa kluczową rolę w naszej działalności. Są to narzędzia zwiększające wydajność w całej firmie, w tym tworzenie planów pięter i poprawa zarządzania zapasami.

David Jones

Główny inżynier oprogramowania, Agorus Build

Zobacz studium przypadku

Jak mogę pobrać istniejące zakładki z PDF-a?

Odczytywanie danych zakładek z pliku PDF jest wymogiem w przypadku aktualizacji dokumentów bez odbudowy całej struktury nawigacji. IronPDF udostępnia to poprzez ten sam interfejs BookmarkManager, który jest używany do dodawania zakładek. Załaduj PDF z PdfDocument.fromFile(), uzyskaj dostęp do BookmarkManager, a następnie wywołaj getBookmarks(), aby pobrać wszystkie zakładki najwyższego poziomu.

Użyj get(index), aby uzyskać dostęp do określonej zakładki według jej pozycji na liście. Metoda getText() zwraca etykietę wyświetlaną zakładki, a getPageIndex() zwraca zerobazowy numer strony, do której się odnosi. Zakładki dziecka nie są zawarte w płaskiej liście zwracanej przez @@--CODE-248@@; uzyskaj do nich dostęp przez metodę getChildren() każdej zakładki rodzica.

//:path=/static-assets/ironpdf-java/content-code-examples/how-to/bookmarks/retrieve-bookmarks.java
import java.io.IOException;
import java.nio.file.Path;
import java.util.List;
import com.ironsoftware.ironpdf.License;
import com.ironsoftware.ironpdf.PdfDocument;
import com.ironsoftware.ironpdf.bookmark.Bookmark;
import com.ironsoftware.ironpdf.bookmark.BookmarkManager;

public class Main {
    public static void main(String[] args) throws IOException {
        // Set the license key
        License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

        // Load the PDF file with bookmarks
        PdfDocument pdf = PdfDocument.fromFile(Path.of("bookmarked.pdf"));

        // Retrieve the bookmark manager
        BookmarkManager bookmarks = pdf.getBookmark();

        // Retrieve list of all bookmarks (includes child bookmarks)
        List<Bookmark> bookmarkList = bookmarks.getBookmarks();

        // Access a specific bookmark by zero-based index
        Bookmark bookmark = bookmarkList.get(2);

        // Print bookmark details
        System.out.println("Bookmark Title: " + bookmark.getText());
        System.out.println("Page Number: " + bookmark.getPageIndex());

        // Check if bookmark has children
        if (bookmark.getChildren() != null && !bookmark.getChildren().isEmpty()) {
            System.out.println("Number of child bookmarks: " + bookmark.getChildren().size());
        }
    }
}

//:path=/static-assets/ironpdf-java/content-code-examples/how-to/bookmarks/retrieve-bookmarks.java
import java.io.IOException;
import java.nio.file.Path;
import java.util.List;
import com.ironsoftware.ironpdf.License;
import com.ironsoftware.ironpdf.PdfDocument;
import com.ironsoftware.ironpdf.bookmark.Bookmark;
import com.ironsoftware.ironpdf.bookmark.BookmarkManager;

public class Main {
    public static void main(String[] args) throws IOException {
        // Set the license key
        License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

        // Load the PDF file with bookmarks
        PdfDocument pdf = PdfDocument.fromFile(Path.of("bookmarked.pdf"));

        // Retrieve the bookmark manager
        BookmarkManager bookmarks = pdf.getBookmark();

        // Retrieve list of all bookmarks (includes child bookmarks)
        List<Bookmark> bookmarkList = bookmarks.getBookmarks();

        // Access a specific bookmark by zero-based index
        Bookmark bookmark = bookmarkList.get(2);

        // Print bookmark details
        System.out.println("Bookmark Title: " + bookmark.getText());
        System.out.println("Page Number: " + bookmark.getPageIndex());

        // Check if bookmark has children
        if (bookmark.getChildren() != null && !bookmark.getChildren().isEmpty()) {
            System.out.println("Number of child bookmarks: " + bookmark.getChildren().size());
        }
    }
}

Ten wzorzec odzyskiwania jest użyteczny przy audytowaniu struktury nawigacyjnej istniejącego pliku PDF przed dystrybucją lub przy budowaniu narzędzi, które muszą sprawdzać, czy wymagane sekcje są poprawnie zaznaczone przed publikacją.

Jak mogę dodać zakładkę w określonym indeksie?

Wstawianie zakładek w określonej pozycji pozwala na aktualizację istniejących plików PDF stopniowo, dodając nowe sekcje bez potrzeby odbudowywania całego konspektu od zera. Jest to szczególnie przydatne, gdy pliki PDF są generowane lub modyfikowane w ramach przepływu zadań, a nowa zawartość jest dodawana na końcu.

Pobierz płaską listę zakładek za pomocą getBookmarks(), wybierz celowaną zakładkę według jej indeksu na liście, a następnie wywołaj addNextBookmark, aby wstawić nową zakładkę rodzeństwa bezpośrednio po niej. Użyj addChildBookmark, aby umieścić nowy wpis jeden poziom głębiej, zagnieżdżony pod wybraną zakładką. Obie metody przyjmują ciąg tytułu i indeks strony zaczynający się od zera.

//:path=/static-assets/ironpdf-java/content-code-examples/how-to/bookmarks/insert-at-index.java
import java.io.IOException;
import java.nio.file.Path;
import java.util.List;
import com.ironsoftware.ironpdf.License;
import com.ironsoftware.ironpdf.PdfDocument;
import com.ironsoftware.ironpdf.bookmark.Bookmark;
import com.ironsoftware.ironpdf.bookmark.BookmarkManager;

public class Main {
    public static void main(String[] args) throws IOException {
        // Set the license key
        License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

        // Load the PDF modified in the multi-layer example
        PdfDocument pdf = PdfDocument.fromFile(Path.of("multiLayer.pdf"));

        // Get the BookmarkManager
        BookmarkManager bookmarks = pdf.getBookmark();

        // Retrieve the flat bookmark list
        List<Bookmark> bookmarkList = bookmarks.getBookmarks();

        // Select a bookmark at a specific index
        Bookmark bookmark = bookmarkList.get(5);

        // Insert a new bookmark after the selected entry
        bookmark.addNextBookmark("Fourth Page", 6);

        // Add a child bookmark under the selected entry
        bookmark.addChildBookmark("Section 1", 7);

        // Save the updated PDF
        pdf.saveAs(Path.of("specificIndex.pdf"));
    }
}

//:path=/static-assets/ironpdf-java/content-code-examples/how-to/bookmarks/insert-at-index.java
import java.io.IOException;
import java.nio.file.Path;
import java.util.List;
import com.ironsoftware.ironpdf.License;
import com.ironsoftware.ironpdf.PdfDocument;
import com.ironsoftware.ironpdf.bookmark.Bookmark;
import com.ironsoftware.ironpdf.bookmark.BookmarkManager;

public class Main {
    public static void main(String[] args) throws IOException {
        // Set the license key
        License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

        // Load the PDF modified in the multi-layer example
        PdfDocument pdf = PdfDocument.fromFile(Path.of("multiLayer.pdf"));

        // Get the BookmarkManager
        BookmarkManager bookmarks = pdf.getBookmark();

        // Retrieve the flat bookmark list
        List<Bookmark> bookmarkList = bookmarks.getBookmarks();

        // Select a bookmark at a specific index
        Bookmark bookmark = bookmarkList.get(5);

        // Insert a new bookmark after the selected entry
        bookmark.addNextBookmark("Fourth Page", 6);

        // Add a child bookmark under the selected entry
        bookmark.addChildBookmark("Section 1", 7);

        // Save the updated PDF
        pdf.saveAs(Path.of("specificIndex.pdf"));
    }
}

Metoda addNextBookmark wstawia nowe wpisy jako rodzeństwo wybranej zakładki, zaraz po niej na liście. Metoda addChildBookmark umieszcza nowy wpis jeden poziom głębiej, zagnieżdżony pod wybraną zakładką. Obie metody przyjmują ciąg tytułu i indeks strony zaczynający się od zera.

Jakie są następne kroki dotyczące zakładek PDF w Java?

Zakładki PDF umożliwiają użytkownikom bezpośrednią nawigację przez złożone dokumenty bez przewijania. Silnik BookmarkManager IronPDF obsługuje pełen zakres operacji na zakładkach: dodawanie płaskich list wpisów, budowanie głębokich wielopoziomowych konturów, pobieranie istniejących wpisów i wstawianie w określonych pozycjach.

Aby kontynuować pracę z funkcjami struktury dokumentu i nawigacji, zapoznaj się z tymi zasobami:

• Podziel PDFy w Java: twórz mniejsze, samodzielne dokumenty, które każdy przenoszą swoją własną strukturę zakładek.
• Drukuj PDFy w Java: wyślij dokumenty z zakładkami do drukarki zachowując nawigację.
• Java PDF tutorials: dodatkowe przykłady end-to-end dla typowych procesów pracy z PDF.
• Dodawanie adnotacji do PDF w Java: dołącz komentarze i oznaczenia w określonych lokalizacjach na stronie.
• IronPDF for Java examples: kopiuj-wklejaj przykłady z pełnego API Java IronPDF.

Rozpocznij bezpłatny okres próbny, aby dodać zakładki, konspekty i inne funkcje nawigacyjne do procesu pracy z PDF w Java. Aby zakupić licencję do użycia produkcyjnego, zobacz opcje licencjonowania.