Documentation – 注释

Python-Net: 添加插入符号注释

Mon, 08 Jun 2026 00:00:00 +0000

插入符号注释通常用于指示文档中的文字插入或编辑性评论。使用 PdfContentEditor，您可以通过指定页码、注释边界、指示区、符号、备注文字和颜色，以编程方式添加插入符号注释。

创建 PdfContentEditor 对象。
绑定输入 PDF。
定义插入符号注释参数：

将添加注释的页码
插入符号矩形（注释位置）
呼出矩形（文本区域）
符号（例如 “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: 添加自由文本批注

Mon, 08 Jun 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: 添加标记注释

Mon, 08 Jun 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: 添加弹出注释

Mon, 08 Jun 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: 添加文本注释

Mon, 08 Jun 2026 00:00:00 +0000

本文展示了如何使用 PdfContentEditor Aspose.PDF 中的类。

文本批注允许您将评论、注释或额外信息附加到 PDF 页面上的特定位置。这些批注可以以图标形式出现，并在用户查看文档时展开。

在此示例中：

将 PDF 文档加载到 PdfContentEditor 中。
在页面的特定位置添加文本注释。
该注释包括标题、内容、图标类型和可见性设置。
修改后的文档保存为新文件。

创建一个 PdfContentEditor 对象。
绑定输入 PDF 文档。
定义注释位置。
添加文本注释。
保存更新后的 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)