Documentation – 链接和导航

Python-Net: 添加应用链接

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

PDF 可以包含交互式元素，例如启动外部应用程序的链接。使用 PdfContentEditor，您可以在页面上定义一个矩形区域，点击后打开特定的可执行文件。

创建一个 PdfContentEditor 实例。
绑定输入的 PDF 文档。
为可点击链接定义一个矩形区域。
指定要启动的应用程序路径。
设置链接颜色。
保存更新后的 PDF 文档。

import aspose.pdf.facades as pdf_facades
from aspose.pycore import cast, is_assignable
import aspose.pydrawing as apd
import aspose.pdf as ap

import sys
from os import path

sys.path.append(path.join(path.dirname(__file__), ".."))

from config import set_license, initialize_data_dir


def add_application_link(infile, outfile):
    # Create PdfContentEditor object
    content_editor = pdf_facades.PdfContentEditor()
    # Bind document to PdfContentEditor
    content_editor.bind_pdf(infile)
    # Add application launch link
    content_editor.create_application_link(
        apd.Rectangle(180, 530, 260, 20),
        "notepad.exe",
        1,
        apd.Color.purple,
    )
    # Save updated document
    content_editor.save(outfile)

Python-Net: 添加自定义操作链接

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

自定义操作链接允许您在 PDF 中定义交互区域，点击时可触发特定操作，例如执行脚本、导航页面或运行特定应用程序的命令。Using PdfContentEditor, 您可以通过指定页面、矩形、颜色和操作来创建自定义操作链接。

创建一个 PdfContentEditor 实例。
绑定输入的 PDF 文档。
为可点击链接定义一个矩形。
指定页码和链接颜色。
分配自定义操作（本示例为空）。
保存更新后的 PDF 文档。

import aspose.pdf.facades as pdf_facades
from aspose.pycore import cast, is_assignable
import aspose.pydrawing as apd
import aspose.pdf as ap

import sys
from os import path

sys.path.append(path.join(path.dirname(__file__), ".."))

from config import set_license, initialize_data_dir


def add_custom_action_link(infile, outfile):
    # Create PdfContentEditor object
    content_editor = pdf_facades.PdfContentEditor()
    # Bind document to PdfContentEditor
    content_editor.bind_pdf(infile)
    # Add custom action link. Empty action list keeps the sample runnable
    # without requiring additional enum lookups.
    content_editor.create_custom_action_link(
        apd.Rectangle(200, 500, 260, 20),
        1,
        apd.Color.dark_red,
        [],
    )
    # Save updated document
    content_editor.save(outfile)

Python-Net: 添加 JavaScript 链接

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

PDF 中的 JavaScript 链接允许交互功能，例如显示警报、执行计算或动态修改文档内容。使用 PdfContentEditor，您可以在页面上定义一个可点击的矩形，并将其关联到自定义的 JavaScript 代码。

创建一个 PdfContentEditor 实例。
绑定输入的 PDF 文档。
为可点击的 JavaScript 链接定义一个矩形。
指定页码和链接颜色。
分配 JavaScript 代码以在点击时执行。
保存更新后的 PDF 文档。

import aspose.pdf.facades as pdf_facades
from aspose.pycore import cast, is_assignable
import aspose.pydrawing as apd
import aspose.pdf as ap

import sys
from os import path

sys.path.append(path.join(path.dirname(__file__), ".."))

from config import set_license, initialize_data_dir


def add_javascript_link(infile, outfile):
    # Create PdfContentEditor object
    content_editor = pdf_facades.PdfContentEditor()
    # Bind document to PdfContentEditor
    content_editor.bind_pdf(infile)
    # Add JavaScript link action
    content_editor.create_java_script_link(
        "app.alert('PdfContentEditor JavaScript link');",
        apd.Rectangle(160, 560, 260, 20),
        1,
        apd.Color.orange,
    )
    # Save updated document
    content_editor.save(outfile)

Python-Net: 添加本地链接

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

本地链接在 PDF 中允许在同一文档的页面之间快速导航。使用 PdfContentEditor，您可以定义一个可点击的矩形，将一个页面链接到另一个页面，从而提升文档的可用性和导航性。

创建一个 PdfContentEditor 实例。
绑定输入的 PDF 文档。
为可点击的本地链接定义一个矩形。
指定源页面和目标页面。
设置链接颜色。
保存更新后的 PDF 文档。

import aspose.pdf.facades as pdf_facades
from aspose.pycore import cast, is_assignable
import aspose.pydrawing as apd
import aspose.pdf as ap

import sys
from os import path

sys.path.append(path.join(path.dirname(__file__), ".."))

from config import set_license, initialize_data_dir


def add_local_link(infile, outfile):
    # Create PdfContentEditor object
    content_editor = pdf_facades.PdfContentEditor()
    # Bind document to PdfContentEditor
    content_editor.bind_pdf(infile)
    # Add a local link on page 1 to destination page 1
    content_editor.create_local_link(
        apd.Rectangle(120, 620, 220, 20),
        1,
        1,
        apd.Color.red,
    )
    # Save updated document
    content_editor.save(outfile)

Python-Net: 添加 PDF 文档链接

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

PDF 文档链接允许用户无缝地从一个 PDF 导航到另一个 PDF。使用 PdfContentEditor, 您可以定义一个可点击的矩形，链接到另一个 PDF 文件中的页面，使您的文档具有交互性并相互连接。

创建一个 PdfContentEditor 实例。
绑定输入的 PDF 文档。
为可点击链接定义一个矩形。
指定链接的 PDF 文件、源页面和目标页面。
设置链接颜色。
保存更新后的 PDF 文档。

import aspose.pdf.facades as pdf_facades
from aspose.pycore import cast, is_assignable
import aspose.pydrawing as apd
import aspose.pdf as ap

import sys
from os import path

sys.path.append(path.join(path.dirname(__file__), ".."))

from config import set_license, initialize_data_dir


def add_pdf_document_link(infile, linked_pdf, outfile):
    # Create PdfContentEditor object
    content_editor = pdf_facades.PdfContentEditor()
    # Bind document to PdfContentEditor
    content_editor.bind_pdf(infile)
    # Add link to another PDF document
    content_editor.create_pdf_document_link(
        apd.Rectangle(140, 590, 240, 20),
        linked_pdf,
        1,
        1,
        apd.Color.green,
    )
    # Save updated document
    content_editor.save(outfile)

Python-Net: 添加网页链接

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

PDF 中的网页链接允许用户直接导航到在线资源、网站或文档。使用 PdfContentEditor，您可以在 PDF 页面上定义一个矩形区域，该区域在点击时会在默认网页浏览器中打开 URL。

创建一个 PdfContentEditor 实例。
绑定输入的 PDF 文档。
为可点击的网页链接定义一个矩形。
指定 URL、页码和链接颜色。
保存更新后的 PDF 文档。

import aspose.pdf.facades as pdf_facades
from aspose.pycore import cast, is_assignable
import aspose.pydrawing as apd
import aspose.pdf as ap

import sys
from os import path

sys.path.append(path.join(path.dirname(__file__), ".."))

from config import set_license, initialize_data_dir


def add_web_link(infile, outfile):
    # Create PdfContentEditor object
    content_editor = pdf_facades.PdfContentEditor()
    # Bind document to PdfContentEditor
    content_editor.bind_pdf(infile)
    # Add a web link annotation to page 1
    content_editor.create_web_link(
        apd.Rectangle(100, 650, 200, 20),
        "https://products.aspose.com/pdf/python-net/",
        1,
        apd.Color.blue,
    )
    # Save updated document
    content_editor.save(outfile)

Python-Net: 提取链接

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

PDF 通常包含交互元素，例如网页链接、文档链接和自定义操作。使用 PdfContentEditor，您可以以编程方式从 PDF 中提取所有链接注释。这使您能够检查或处理链接，例如验证 URL 或分析文档中的导航模式。

创建一个 PdfContentEditor 实例。
绑定输入的 PDF 文档。
使用 ’extract_link()’ 提取所有链接。
遍历已提取的链接。
检查链接是否为 LinkAnnotation，以及其操作是否为 GoToURIAction。
打印矩形坐标和 URI。
如果未找到链接，则显示一条消息。

import aspose.pdf.facades as pdf_facades
from aspose.pycore import cast, is_assignable
import aspose.pydrawing as apd
import aspose.pdf as ap

import sys
from os import path

sys.path.append(path.join(path.dirname(__file__), ".."))

from config import set_license, initialize_data_dir


def extract_links(infile):
    # Create PdfContentEditor object
    content_editor = pdf_facades.PdfContentEditor()
    # Bind document to PdfContentEditor
    content_editor.bind_pdf(infile)
    # Extract links from the document
    links = content_editor.extract_link()

    count = 0
    for link in links:
        count += 1
        print(f"Link {count}: {link.rect}")
        if is_assignable(link, ap.annotations.LinkAnnotation):
            annotation = cast(ap.annotations.LinkAnnotation, link)
            if is_assignable(annotation.action, ap.annotations.GoToURIAction):
                action = cast(ap.annotations.GoToURIAction, annotation.action)
                print(f"  URI: {action.uri}")

    if count == 0:
        print("No links found")