Documentation – Аннотации

Python-Net: Добавить аннотации в виде курсора

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

Аннотации в виде курсора обычно используются для указания вставок текста или редакционных комментариев в документе. С помощью PdfContentEditor можно программно добавлять аннотации в виде курсора, указывая номер страницы, границы аннотации, область выноски, символ, текст заметки и цвет.

Создайте PdfContentEditor объект.
Привяжите входной PDF.
Определите параметры аннотации Caret:

Номер страницы, где будет добавлена аннотация
Прямоугольник Caret (позиция аннотации)
Прямоугольник выноски (текстовая область)
Символ (например “P”)
Текст аннотации
Цвет аннотации

Добавьте аннотацию в виде курсора.
Сохраните обновлённый Document.

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: Добавить свободные текстовые аннотации

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

Свободные текстовые аннотации позволяют размещать видимый текст непосредственно на странице PDF без необходимости всплывающих комментариев. С помощью PdfContentEditor можно указать прямоугольник аннотации, отображаемый текст и целевую страницу.

Создайте PdfContentEditor объект.
Привяжите входной PDF.
Определите позицию аннотации.
Добавьте аннотацию свободного текста.
Сохраните обновлённый Document.

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: Добавить аннотации разметки

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

Аннотации разметки используются для выделения или рецензирования текста в PDF. С помощью PdfContentEditor можно программно применять различные стили разметки, указывая область прямоугольника, текст комментария, тип разметки, номер страницы и цвет.

Создайте PdfContentEditor объект.
Привяжите входной PDF.
Определите прямоугольники аннотаций.
Добавьте разметку аннотаций.
Сохраните обновлённый Document.

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: Добавить всплывающие аннотации

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

Всплывающие аннотации полезны для добавления комментариев, пояснений или интерактивных заметок в PDF‑файлах. С помощью PdfContentEditor, вы можете создавать всплывающие аннотации программно, указывая местоположение, содержание, видимость и номер страницы.

Создайте объект PdfContentEditor.
Привяжите входной PDF.
Определите прямоугольник всплывающей аннотации.
Добавьте всплывающую аннотацию.
Сохраните обновлённый Document.

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: Добавить текстовые аннотации

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

В этой статье показано, как добавить текстовую аннотацию в PDF‑документ с помощью PdfContentEditor класса в Aspose.PDF.

Текстовые аннотации позволяют прикреплять комментарии, заметки или дополнительную информацию к определённым частям страницы PDF. Такие аннотации могут отображаться в виде значков и расширяться пользователями при просмотре документа.

В этом примере:

PDF‑документ загружается в PdfContentEditor.
Текстовая аннотация добавляется в определённую позицию на странице.
Аннотация включает заголовок, содержимое, тип значка и настройки видимости.
Изменённый документ сохраняется в новый файл.

Создайте объект PdfContentEditor.
Привяжите входной PDF Document.
Определите позицию аннотации.
Добавьте аннотацию Text.
Сохраните обновлённый PDF.

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)