Documentation – Anotaciones

Python-Net: Agregar anotación de caret

Fri, 20 Mar 2026 00:00:00 +0000

Las anotaciones de caret se utilizan comúnmente para indicar inserciones de texto o comentarios editoriales en un documento. Con PdfContentEditor, puedes agregar anotaciones de caret de forma programática especificando el número de página, los límites de la anotación, el área de llamada, el símbolo, el texto de la nota y el color.

Crear el PdfContentEditor objeto.
Vincular el PDF de entrada.
Definir los parámetros de la anotación Caret:

Número de página donde se añadirá la anotación
Caret rectangle (posición de la anotación)
Rectángulo de llamada (área de texto)
Símbolo (por ejemplo “P”)
Texto de anotación
Color de anotación

Agregar la anotación de cursor.
Guardar el documento actualizado.

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: Agregar anotaciones de texto libre

Fri, 20 Mar 2026 00:00:00 +0000

Las anotaciones de texto libre le permiten colocar texto visible directamente en una página PDF sin requerir comentarios emergentes. Usando PdfContentEditor, puede especificar el rectángulo de la anotación, el texto mostrado y la página objetivo.

Crear el PdfContentEditor objeto.
Vincular el PDF de entrada.
Defina la posición de la anotación.
Agregar la anotación de texto libre.
Guardar el documento actualizado.

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: Agregar anotaciones de marcado

Fri, 20 Mar 2026 00:00:00 +0000

Las anotaciones de marcado se utilizan para enfatizar o revisar texto dentro de un PDF. Con PdfContentEditor, puedes aplicar programáticamente diferentes estilos de marcado especificando un área rectangular, texto de comentario, tipo de marcado, número de página y color.

Crear el PdfContentEditor objeto.
Vincular el PDF de entrada.
Definir rectángulos de anotación.
Agregar anotaciones de marcado.
Guardar el documento actualizado.

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: Agregar anotaciones emergentes

Fri, 20 Mar 2026 00:00:00 +0000

Las anotaciones emergentes son útiles para agregar comentarios, explicaciones o notas interactivas en archivos PDF. Usando PdfContentEditor, puedes crear anotaciones emergentes programáticamente especificando la ubicación, el contenido, la visibilidad y el número de página.

Crea el objeto PdfContentEditor.
Vincular el PDF de entrada.
Define el rectángulo de la anotación Popup.
Añade la anotación Popup.
Guardar el documento actualizado.

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: Agregar anotaciones de texto

Fri, 20 Mar 2026 00:00:00 +0000

Este artículo muestra cómo agregar una anotación de texto a un documento PDF utilizando la PdfContentEditor clase en Aspose.PDF.

Las anotaciones de texto le permiten adjuntar comentarios, notas o información adicional a partes específicas de una página PDF. Estas anotaciones pueden aparecer como íconos y ser ampliadas por los usuarios al ver el documento.

En este ejemplo:

Se carga un documento PDF en el PdfContentEditor.
Se agrega una anotación de texto en una posición específica de la página.
La anotación incluye un título, contenido, tipo de ícono y configuraciones de visibilidad.
El documento modificado se guarda en un nuevo archivo.

Crear un objeto PdfContentEditor.
Vincular el documento PDF de entrada.
Definir la posición de la anotación.
Agregar anotación de texto.
Guardar el PDF actualizado.

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)