Esboços e Marcadores

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")

Esboços e Marcadores

IronPDF for Python pode adicionar um esboço de marcador de navegação a documentos PDF, criando um painel de índice que os leitores podem usar para saltar diretamente para qualquer seção — incluindo sub-seções aninhadas.

Começando

Carregue ou crie um PdfDocument, então use a coleção pdf.Bookmarks para adicionar entradas de marcadores. Chame AddBookMarkAtEnd para anexar entradas à lista de marcadores ou AddBookMarkAtStart em uma coleção filha para aninhar sub-marcadores abaixo de um pai.

Entendendo o código

pdf.Bookmarks.AddBookMarkAtEnd(title, pageIndex): Anexa um novo marcador ao fim da lista de marcadores de nível superior. pageIndex é o índice de página baseado em zero para o qual o marcador é vinculado. Retorna o novo objeto de marcador.
bookmark.Children.AddBookMarkAtStart(title, pageIndex): Adiciona um marcador filho abaixo de um marcador existente, criando uma hierarquia aninhada. Retorna o objeto de marcador filho.
pdf.Bookmarks.AddBookMarkAtEnd("References", 20): Anexa outro marcador após todas as entradas existentes.
SaveAs(path): Salva o documento com todos os marcadores embutidos no esboço PDF.

Hierarquia de Marcadores

Os marcadores de PDF suportam múltiplos níveis de aninhamento. Cada marcador retornado por AddBookMarkAtEnd ou AddBookMarkAtStart tem sua própria coleção .Children, permitindo construir árvores de profundidade arbitrária.