Outlines & Lesezeichen

from ironpdf import *

# Create a new PDF or edit an existing document.
pdf = PdfDocument.FromFile("existing.pdf")

# Add bookmark
pdf.Bookmarks.AddBookMarkAtEnd("Author's Note", 2)
pdf.Bookmarks.AddBookMarkAtEnd("Table of Contents", 3)

# Store new bookmark in a variable to add nested bookmarks to
summaryBookmark = pdf.Bookmarks.AddBookMarkAtEnd("Summary", 17)

# Add a sub-bookmark within the summary
conclusionBookmark = summaryBookmark.Children.AddBookMarkAtStart("Conclusion", 18)

# Add another bookmark to end of highest-level bookmark list
pdf.Bookmarks.AddBookMarkAtEnd("References", 20)

pdf.SaveAs("existing.pdf")

Outlines & Lesezeichen

IronPDF for Python kann eine navigierbare Lesezeichenübersicht zu PDF-Dokumenten hinzufügen, indem ein Inhaltsverzeichnisfenster erstellt wird, das Lesern ermöglicht, direkt zu beliebigen Abschnitten zu springen – einschließlich verschachtelter Unterabschnitte.

Einstieg

Laden oder erstellen Sie eine PdfDocument, und verwenden Sie dann die pdf.Bookmarks-Sammlung, um Lesezeichenhinweise hinzuzufügen. Rufen Sie AddBookMarkAtEnd auf, um Einträge in die Lesezeichenliste anzufügen, oder AddBookMarkAtStart auf einer untergeordneten Sammlung, um Unterlesezeichen unter einem Elternzeichen zu verschachteln.

Den Code verstehen

pdf.Bookmarks.AddBookMarkAtEnd(title, pageIndex): Fügt ein neues Lesezeichen am Ende der Lesezeichenliste auf oberster Ebene an. pageIndex ist der nullbasierte Seitenindex, auf den das Lesezeichen verweist. Gibt das neue Lesezeichenobjekt zurück.
bookmark.Children.AddBookMarkAtStart(title, pageIndex): Fügt ein untergeordnetes Lesezeichen unter einem vorhandenen Lesezeichen hinzu und erstellt eine verschachtelte Hierarchie. Gibt das untergeordnete Lesezeichenobjekt zurück.
pdf.Bookmarks.AddBookMarkAtEnd("References", 20): Fügt ein weiteres Lesezeichen nach allen vorhandenen Einträgen an.
SaveAs(path): Speichert das Dokument mit allen in die PDF-Gliederung eingebetteten Lesezeichen.

Lesezeichenhierarchie

PDF-Lesezeichen unterstützen mehrere Verschachtelungsebenen. Jedes Lesezeichen, das durch AddBookMarkAtEnd oder AddBookMarkAtStart zurückgegeben wird, hat seine eigene .Children-Sammlung, wodurch sich Bäume beliebiger Tiefe erstellen lassen.