Documentation – Annotations

Python-Net: Ajouter une annotation caret

Fri, 22 May 2026 00:00:00 +0000

Les annotations caret sont couramment utilisées pour indiquer des insertions de texte ou des commentaires éditoriaux dans un document. Avec PdfContentEditor, vous pouvez ajouter des annotations caret de manière programmatique en spécifiant le numéro de page, les limites de l’annotation, la zone d’appel, le symbole, le texte de la note et la couleur.

Créer le PdfContentEditor objet.
Lier le PDF d’entrée.
Définir les paramètres de l’annotation Caret :

Numéro de page où l’annotation sera ajoutée
Rectangle Caret (position de l’annotation)
Rectangle d’appel (zone de texte)
Symbole (par exemple “P”)
Texte d’annotation
Couleur d’annotation

Ajouter l’annotation Caret.
Enregistrer le Document mis à jour.

import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades
import aspose.pydrawing as apd
import sys
from os import path

sys.path.append(path.join(path.dirname(__file__), ".."))

from config import set_license, initialize_data_dir


def add_caret_annotation(infile, outfile):
    # Create PdfContentEditor object
    content_editor = pdf_facades.PdfContentEditor()
    # Bind document to PdfContentEditor
    content_editor.bind_pdf(infile)
    # Add caret annotation to page 1
    content_editor.create_caret(
        1,
        apd.Rectangle(350, 400, 10, 10),
        apd.Rectangle(300, 380, 115, 15),
        "P",
        "This is a caret annotation",
        apd.Color.red,
    )
    # Save updated document
    content_editor.save(outfile)

Python-Net: Ajouter des annotations de texte libre

Fri, 22 May 2026 00:00:00 +0000

Les annotations de texte libre vous permettent de placer du texte visible directement sur une page PDF sans nécessiter de commentaires contextuels. En utilisant PdfContentEditor, vous pouvez spécifier le rectangle de l’annotation, le texte affiché et la page cible.

Créer le PdfContentEditor objet.
Lier le PDF d’entrée.
Définir la position de l’annotation.
Ajoutez l’annotation de texte libre.
Enregistrer le Document mis à jour.

import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades
import aspose.pydrawing as apd
import sys
from os import path

sys.path.append(path.join(path.dirname(__file__), ".."))

from config import set_license, initialize_data_dir


def add_free_text_annotation(infile, outfile):
    # Create PdfContentEditor object
    content_editor = pdf_facades.PdfContentEditor()
    # Bind document to PdfContentEditor
    content_editor.bind_pdf(infile)
    # Add free text annotation to page 1
    content_editor.create_free_text(
        apd.Rectangle(200, 480, 150, 25), "This is a free text annotation", 1
    )
    # Save updated document
    content_editor.save(outfile)

Python-Net: Ajouter des annotations de balisage

Fri, 22 May 2026 00:00:00 +0000

Les annotations de balisage sont utilisées pour mettre en évidence ou réviser du texte dans un PDF. Avec PdfContentEditor, vous pouvez appliquer programmétiquement différents styles de balisage en spécifiant une zone rectangulaire, le texte du commentaire, le type de balisage, le numéro de page et la couleur.

Créer le PdfContentEditor objet.
Lier le PDF d’entrée.
Définir les rectangles d’annotation.
Ajouter des annotations de balisage.
Enregistrer le Document mis à jour.

import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades
import aspose.pydrawing as apd
import sys
from os import path

sys.path.append(path.join(path.dirname(__file__), ".."))

from config import set_license, initialize_data_dir


def add_markup_annotation(infile, outfile):
    # Create PdfContentEditor object
    content_editor = pdf_facades.PdfContentEditor()
    # Bind document to PdfContentEditor
    content_editor.bind_pdf(infile)
    # Add markup annotation to page 1
    content_editor.create_markup(
        apd.Rectangle(120, 440, 200, 20),
        "This is a highlight annotation",
        0,
        1,
        apd.Color.yellow,
    )
    content_editor.create_markup(
        apd.Rectangle(110, 542, 200, 20),
        "This is a underline annotation",
        1,
        1,
        apd.Color.yellow,
    )
    content_editor.create_markup(
        apd.Rectangle(120, 568, 200, 20),
        "This is a strikeout annotation",
        2,
        1,
        apd.Color.orange_red,
    )
    content_editor.create_markup(
        apd.Rectangle(110, 598, 200, 20),
        "This is a squiggly annotation",
        3,
        1,
        apd.Color.dark_blue,
    )
    # Save updated document
    content_editor.save(outfile)

Python-Net: Ajouter des annotations contextuelles

Fri, 22 May 2026 00:00:00 +0000

Les annotations contextuelles sont utiles pour ajouter des commentaires, des explications ou des notes interactives dans les fichiers PDF. En utilisant PdfContentEditor, vous pouvez créer des annotations contextuelles programmatiquement en spécifiant l’emplacement, le contenu, la visibilité et le numéro de page.

Créer l’objet PdfContentEditor.
Lier le PDF d’entrée.
Définir le rectangle de l’annotation Popup.
Ajouter l’annotation Popup.
Enregistrer le Document mis à jour.

import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades
import aspose.pydrawing as apd
import sys
from os import path

sys.path.append(path.join(path.dirname(__file__), ".."))

from config import set_license, initialize_data_dir


def add_popup_annotation(infile, outfile):
    # Create PdfContentEditor object
    content_editor = pdf_facades.PdfContentEditor()
    # Bind document to PdfContentEditor
    content_editor.bind_pdf(infile)
    # Add popup annotation to page 1
    content_editor.create_popup(
        apd.Rectangle(220, 520, 180, 80),
        "This is a popup annotation",
        True,
        1,
    )
    # Save updated document
    content_editor.save(outfile)

Python-Net: Ajouter des annotations de texte

Fri, 22 May 2026 00:00:00 +0000

Cet article montre comment ajouter une annotation de texte à un document PDF en utilisant le PdfContentEditor classe dans Aspose.PDF.

Les annotations de texte vous permettent d’ajouter des commentaires, des notes ou des informations supplémentaires à des parties spécifiques d’une page PDF. Ces annotations peuvent apparaître sous forme d’icônes et être développées par les utilisateurs lors de la visualisation du document.

Dans cet exemple :

Un document PDF est chargé dans le PdfContentEditor.
Une annotation de texte est ajoutée à une position spécifique sur la page.
L’annotation comprend un titre, un contenu, un type d’icône et des paramètres de visibilité.
Le document modifié est enregistré dans un nouveau fichier.

Créer un objet PdfContentEditor.
Lier le Document PDF d’entrée.
Définir la position de l’annotation.
Ajouter une annotation Text.
Enregistrer le PDF mis à jour.

import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades
import aspose.pydrawing as apd
import sys
from os import path

sys.path.append(path.join(path.dirname(__file__), ".."))

from config import set_license, initialize_data_dir


def add_text_annotation(infile, outfile):
    # Create PdfContentEditor object
    content_editor = pdf_facades.PdfContentEditor()
    # Bind document to PdfContentEditor
    content_editor.bind_pdf(infile)
    # Add text annotation to page 1
    content_editor.create_text(
        apd.Rectangle(100, 400, 50, 50),
        "Text Annotation",
        "This is a text annotation",
        True,
        "Insert",
        1,
    )
    # Save updated document
    content_editor.save(outfile)