Documentation – Anotações

Python-Net: Adicionar Anotação de Caret

Mon, 18 May 2026 00:00:00 +0000

Anotações de caret são comumente usadas para indicar inserções de texto ou comentários editoriais em um documento. Com o PdfContentEditor, você pode adicionar anotações de caret programaticamente, especificando o número da página, os limites da anotação, a área de chamada, o símbolo, o texto da nota e a cor.

Criar o PdfContentEditor objeto.
Vincular o PDF de entrada.
Definir parâmetros da Anotação Caret:

Número da página onde a anotação será adicionada
Retângulo Caret (posição da anotação)
Retângulo de chamada (área de texto)
Símbolo (por exemplo “P”)
Texto da anotação
Cor da anotação

Adicionar a anotação de cursor.
Salvar o Document atualizado.

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: Adicionar Anotações de Texto Livre

Mon, 18 May 2026 00:00:00 +0000

Anotações de texto livre permitem que você coloque texto visível diretamente em uma página PDF sem a necessidade de comentários pop-up. Usando PdfContentEditor, você pode especificar o retângulo da anotação, o texto exibido e a página de destino.

Criar o PdfContentEditor objeto.
Vincular o PDF de entrada.
Defina a posição da anotação.
Adicionar a Anotação de Texto Livre.
Salvar o Document atualizado.

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: Adicionar Anotações de Marcação

Mon, 18 May 2026 00:00:00 +0000

Anotações de marcação são usadas para enfatizar ou revisar texto dentro de um PDF. Com PdfContentEditor, você pode aplicar programaticamente estilos de marcação diferentes especificando uma área retangular, texto de comentário, tipo de marcação, número da página e cor.

Criar o PdfContentEditor objeto.
Vincular o PDF de entrada.
Definir retângulos de anotação.
Adicionar Anotações de Marcação.
Salvar o Document atualizado.

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: Adicionar Anotações Pop-up

Mon, 18 May 2026 00:00:00 +0000

Anotações pop-up são úteis para adicionar comentários, explicações ou notas interativas em arquivos PDF. Usando PdfContentEditor, você pode criar anotações pop-up programaticamente especificando a localização, o conteúdo, a visibilidade e o número da página.

Crie o objeto PdfContentEditor.
Vincular o PDF de entrada.
Defina o retângulo da Anotação Popup.
Adicione a Anotação Popup.
Salvar o Document atualizado.

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: Adicionar Anotações de Texto

Mon, 18 May 2026 00:00:00 +0000

Este artigo mostra como adicionar uma anotação de texto a um documento PDF usando o PdfContentEditor classe no Aspose.PDF.

Anotações de texto permitem que você anexe comentários, notas ou informações extra a partes específicas de uma página de PDF. Essas anotações podem aparecer como ícones e ser expandidas pelos usuários ao visualizar o documento.

Neste exemplo:

Um documento PDF é carregado no PdfContentEditor.
Uma anotação de texto é adicionada em uma posição específica na página.
A anotação inclui um título, conteúdo, tipo de ícone e configurações de visibilidade.
O documento modificado é salvo em um novo arquivo.

Crie um objeto PdfContentEditor.
Vincule o Document PDF de entrada.
Defina a posição da anotação.
Adicione anotação de texto.
Salve o PDF atualizado.

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)