Annotations

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

Annotations

IronPDF for Python peut ajouter des annotations de texte interactives — également appelées notes adhésives — aux documents PDF, ce qui vous permet d'attacher des commentaires, des notes de révision ou des métadonnées à des emplacements spécifiques sur une page.

Commencer

Chargez ou créez un PdfDocument, instanciez un TextAnnotation avec l'index de page cible, configurez ses propriétés, ajoutez-le à la collection Annotations du document, et sauvegardez.

Comprendre le code

TextAnnotation(pageIndex) : Crée une nouvelle annotation ciblant l'indice de page spécifié basé sur zéro.
Title : Le texte principal du titre de la fenêtre contextuelle de l'annotation.
Subject : Un sous-titre ou titre secondaire pour l'annotation.
Contents : Le texte principal de l'annotation — le commentaire ou le contenu de la note principal.
Icon : L'icône visuelle affichée sur la page. Les options incluent Help, Note, Comment, Key, et d'autres de TextAnnotation.AnnotationIcon.
X / Y : La position du point d'ancrage de l'annotation sur la page, en points.
Width / Height : Les dimensions de la fenêtre contextuelle de l'annotation.
Opacity : Une valeur de 0,0 à 1,0 contrôlant la transparence de l'annotation.
Printable : Lorsque False, l'annotation n'est pas incluse dans la sortie imprimée.
Hidden : Lorsque False, l'annotation est visible dans le visionneur PDF.
OpenByDefault : Lorsque True, la fenêtre contextuelle de l'annotation s'ouvre lorsque le PDF est d'abord visualisé.
ReadOnly : Lorsque False, les utilisateurs peuvent éditer l'annotation dans un visionneur PDF.
Rotatable : Lorsque True, l'annotation peut être tournée par l'utilisateur.
pdf.Annotations.Add(annotation) : Ajoute l'annotation configurée au document.