Anotaciones

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

Anotaciones

IronPDF for Python puede agregar anotaciones de texto interactivas — también conocidas como notas adhesivas — a documentos PDF, lo que le permite adjuntar comentarios, revisar notas o metadatos a ubicaciones específicas en una página.

Empezando

Cargue o cree un PdfDocument, instancie un TextAnnotation con el índice de la página objetivo, configure sus propiedades, agréguelo a la colección Annotations del documento, y guarde.

Entender el código

TextAnnotation(pageIndex): Crea una nueva anotación que apunta al índice de página especificado basado en cero.
Title: El texto principal del encabezado del popup de anotación.
Subject: Un subtítulo o encabezado secundario para la anotación.
Contents: El texto principal de la anotación: el comentario o contenido de la nota principal.
Icon: El icono visual mostrado en la página. Las opciones incluyen Help, Note, Comment, Key, y otros de TextAnnotation.AnnotationIcon.
X / Y: La posición del punto de anclaje de la anotación en la página, en puntos.
Width / Height: Las dimensiones del cuadro emergente de anotación.
Opacity: Un valor de 0.0 a 1.0 que controla la transparencia de la anotación.
Printable: Cuando False, la anotación no se incluye en la salida impresa.
Hidden: Cuando False, la anotación es visible en el visor de PDF.
OpenByDefault: Cuando True, el popup de anotación está abierto cuando el PDF se visualiza por primera vez.
ReadOnly: Cuando False, los usuarios pueden editar la anotación en un visor de PDF.
Rotatable: Cuando True, la anotación puede ser rotada por el usuario.
pdf.Annotations.Add(annotation): Agrega la anotación configurada al documento.