Documentation – 绘图批注

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_circle_annotation(infile, outfile):
    # Create PdfContentEditor object
    content_editor = pdf_facades.PdfContentEditor()
    # Bind input PDF file
    content_editor.bind_pdf(infile)

    # Create CircleAnnotation object
    rect = apd.Rectangle(300, 300, 400, 400)
    contents = "This is circle annotation"
    content_editor.create_square_circle(rect, contents, apd.Color.blue, False, 1, 3)

    # Save output PDF file
    content_editor.save(outfile)

Python-Net: 添加曲线注释

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

曲线注释用于在 PDF 中突出显示不规则路径或形状，提供视觉强调或标记重要区域。使用 PdfContentEditor, 您可以通过指定顶点序列、边框样式、可见性、注释矩形以及描述性文本来绘制曲线。

创建 PdfContentEditor 对象。
绑定 onput PDF。
配置 Curve 属性。
绘制 Curve 注释。
保存已更新的 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_curve_annotation(infile, outfile):
    # Create PdfContentEditor object
    content_editor = pdf_facades.PdfContentEditor()
    # Bind input PDF file
    content_editor.bind_pdf(infile)

    line_info = pdf_facades.LineInfo()
    line_info.border_style = 1  # 1 - Dashed
    line_info.vertice_coordinate = [120, 520, 160, 560, 220, 540, 280, 580]
    line_info.visibility = True
    content_editor.draw_curve(
        line_info,
        1,
        apd.Rectangle(110, 510, 220, 100),
        "This is curve annotation",
    )

    # Save output PDF file
    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_line_annotation(infile, outfile):
    # Create PdfContentEditor object
    content_editor = pdf_facades.PdfContentEditor()
    # Bind input PDF file
    content_editor.bind_pdf(infile)

    # Create LineAnnotation object
    rect = apd.Rectangle(100, 100, 200, 200)
    contents = "This is line annotation"
    content_editor.create_line(
        rect,
        contents,
        100,
        100,
        200,
        200,
        1,
        1,
        apd.Color.red,
        "Solid",
        [3, 2],
        ["Square"],
    )

    # Save output PDF file
    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_polygon_annotation(infile, outfile):
    # Create PdfContentEditor object
    content_editor = pdf_facades.PdfContentEditor()
    # Bind input PDF file
    content_editor.bind_pdf(infile)

    line_info = pdf_facades.LineInfo()
    line_info.border_style = 0  # 0 - Solid
    line_info.vertice_coordinate = [100, 200, 150, 260, 220, 220, 200, 160]
    content_editor.create_polygon(
        line_info,
        1,
        apd.Rectangle(90, 150, 150, 120),
        "This is polygon annotation",
    )

    # Save output PDF file
    content_editor.save(outfile)

Python-Net: 添加折线注释

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

折线注释允许您在 PDF 中突出显示一系列相连的线段。使用 PdfContentEditor，您可以通过指定顶点坐标、边框样式、页码和注释边界来绘制折线。这对在图表和文档中直观地表示路径、趋势或连接非常有用。

创建 PdfContentEditor 对象。
绑定输入 PDF。
配置 Polyline 属性。
添加 Polyline 注释。
保存已更新的 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_polyline_annotation(infile, outfile):
    # Create PdfContentEditor object
    content_editor = pdf_facades.PdfContentEditor()
    # Bind input PDF file
    content_editor.bind_pdf(infile)

    line_info = pdf_facades.LineInfo()
    line_info.border_style = 0  # 0 - Solid
    line_info.vertice_coordinate = [120, 420, 180, 460, 230, 430, 290, 470]
    content_editor.create_poly_line(
        line_info,
        1,
        apd.Rectangle(110, 410, 200, 90),
        "This is polyline annotation",
    )

    # Save output PDF file
    content_editor.save(outfile)

Python-Net: 添加方形注释

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

方形批注通常用于突出显示感兴趣的区域、标记重要章节或在 PDF 文档中提供视觉提示。Using 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_square_annotation(infile, outfile):
    # Create PdfContentEditor object
    content_editor = pdf_facades.PdfContentEditor()
    # Bind input PDF file
    content_editor.bind_pdf(infile)

    # Create SquareAnnotation object
    rect = apd.Rectangle(100, 300, 200, 400)
    contents = "This is square annotation"
    content_editor.create_square_circle(rect, contents, apd.Color.blue, True, 1, 3)

    # Save output PDF file
    content_editor.save(outfile)