Anotações

from ironpdf import *

# Load an existing PDF or create a new one
pdf = PdfDocument("existing.pdf")

pageIndex = 0

# Create a TextAnnotation object
annotation = TextAnnotation(pageIndex)
annotation.Title = "This is the major title"
annotation.Subject = "This is a subtitle"
annotation.Contents = "This is the long 'sticky note' comment content..."
annotation.Icon = TextAnnotation.AnnotationIcon.Help
annotation.X = 150
annotation.Y = 200
annotation.Width = 200
annotation.Height = 50
annotation.Opacity = 0.9
annotation.Printable = False
annotation.Hidden = False
annotation.OpenByDefault = True
annotation.ReadOnly = False
annotation.Rotatable = True

# Add the annotation to a specific page and location within the PDF
pdf.Annotations.Add(annotation)

# Save the PDF
pdf.SaveAs("existing.pdf")

Anotações

IronPDF for Python pode adicionar anotações de texto interativas — também conhecidas como notas adesivas — a documentos PDF, permitindo anexar comentários, notas de revisão ou metadados a locais específicos em uma página.

Começando

Carregue ou crie um PdfDocument, instancie um TextAnnotation com o índice de página de destino, configure suas propriedades, adicione ao documento a coleção Annotations e salve.

Entendendo o código

TextAnnotation(pageIndex): Cria uma nova anotação direcionando para o índice de página baseado em zero especificado.
Title: O texto do título principal da anotação popup.
Subject: Um subtítulo ou título secundário para a anotação.
Contents: O texto do corpo da anotação — o principal comentário ou conteúdo da nota.
Icon: O ícone visual exibido na página. As opções incluem Help, Note, Comment, Key, e outros de TextAnnotation.AnnotationIcon.
X / Y: A posição do ponto âncora da anotação na página, em pontos.
Width / Height: As dimensões da caixa de popup de anotação.
Opacity: Um valor de 0,0 a 1,0 controlando a transparência da anotação.
Printable: Quando False, a anotação não é incluída na saída impressa.
Hidden: Quando False, a anotação é visível no visualizador de PDF.
OpenByDefault: Quando True, o popup da anotação está aberto quando o PDF é primeiro visualizado.
ReadOnly: Quando False, os usuários podem editar a anotação em um visualizador de PDF.
Rotatable: Quando True, a anotação pode ser rotacionada pelo usuário.
pdf.Annotations.Add(annotation): Adiciona a anotação configurada ao documento.