Documentation – 在 Python 中使用 PDF 链接

Python-Net: 在 Python 中创建 PDF 链接

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

PDF 文档中的链接

根据 PDF 1.7 规范（ISO 32000-1:2008），链接注释可以触发多种类型的动作，这些动作定义了注释激活时会发生什么。以下是支持的主要动作：

GoTo – 导航到同一文档中的目标。
GoToR – 跳转到另一个 PDF 文件中的目标（远程跳转）。
URI – 打开统一资源标识符，通常是网页链接。
Launch – 启动一个应用程序或打开一个文件（取决于平台，且通常出于安全原因受到限制）。
Named – 执行预定义的操作，例如转到下一页或打印文档。
JavaScript – 执行嵌入的 JavaScript 代码（因安全考虑需谨慎使用）。
SubmitForm – 将表单数据提交到指定的 URL。
ResetForm – 将表单字段重置为默认值。
ImportData – 将数据从外部文件导入文档。

通过在文档中添加指向应用程序的链接，可以实现从文档链接到应用程序。这在例如希望读者在教程的特定位置执行某个操作，或创建功能丰富的文档时非常有用。

使用‘LaunchAction’创建应用程序链接：

import aspose.pdf as ap
from os import path
import sys

def create_link_annotation_launch_action(infile, outfile):
    document = ap.Document(infile)
    page = document.pages[1]

    link = ap.annotations.LinkAnnotation(page, ap.Rectangle(10, 580, 120, 600, True))
    border = ap.annotations.Border(link)
    border.width = 5
    border.dash = ap.annotations.Dash(1, 1)
    link.color = ap.Color.green
    link.action = ap.annotations.LaunchAction(document, "sample.pdf")
    page.annotations.append(link)
    document.save(outfile)

在 PDF 文件中创建 PDF 文档链接

使用 GoToRemoteAction

此代码片段演示了如何使用 Python PDF 库向 PDF 文档的特定页面添加链接注释。

打开 PDF 文档
选择文档的第二页（索引 1）
创建链接注释：
位于坐标 (10, 580, 120, 600) 处
颜色为绿色
在第一页链接到 ‘sample.pdf’
将链接注释添加到页面
将修改后的文档保存到输出文件路径

使用 ‘GoToRemoteAction’ 创建 PDF 文档链接：

import aspose.pdf as ap
from os import path
import sys

def create_link_annotation_go_to_remote_action(infile, outfile):
    document = ap.Document(infile)
    page = document.pages[1]

    link = ap.annotations.LinkAnnotation(page, ap.Rectangle(10, 580, 120, 600, True))
    link.color = ap.Color.green
    link.action = ap.annotations.GoToRemoteAction("sample.pdf", 1)
    page.annotations.append(link)
    document.save(outfile)

使用 GoToAction

此代码演示了如何使用 Aspose.PDF for Python 向 PDF 文档的特定页面添加链接注释。该链接显示为绿色、虚线边框的矩形，并允许用户在同一 PDF 中导航到另一页。要使用 ‘GoToAction’ 创建 PDF 文档链接：

import aspose.pdf as ap
from os import path
import sys

def create_link_annotation_go_to_action(infile, outfile):
    document = ap.Document(infile)
    page = document.pages[1]

    link = ap.annotations.LinkAnnotation(page, ap.Rectangle(10, 580, 120, 600, True))
    border = ap.annotations.Border(link)
    border.width = 5
    border.dash = ap.annotations.Dash(1, 1)
    link.color = ap.Color.green
    if document.pages.length >= 4:
        link.action = ap.annotations.GoToAction(document.pages[4])
    else:
        link.action = ap.annotations.GoToAction(document.pages[document.pages.length])
    page.annotations.append(link)
    document.save(outfile)

应用 GoToURIAction

下一个示例演示如何使用 Aspose.PDF for Python 向 PDF 文档添加链接批注。该链接在首页上显示为绿色可点击区域，点击后会通过 GoToURIAction 在网页浏览器中打开 Aspose.PDF for Python 文档。

此功能可用于在 PDF 中直接嵌入有用的外部参考、文档或支持链接。

加载 PDF 文档。使用 ap.Document 打开现有的 PDF 文件。
访问第一页。使用 document.pages[1] 访问第一页（Aspose 使用基于 1 的索引）。
创建链接注释。创建一个 LinkAnnotation 对象，并使用 ap.Rectangle 指定可点击的矩形区域。
设置注释外观。使用 link.color = ap.Color.green 将注释的颜色设置为绿色。
分配一个 URI 操作。使用 GoToURIAction 将注释链接到外部 URL。
将注释添加到页面。将配置好的链接注释追加到第一页的注释集合中。
保存已修改的文档。将更新后的 PDF 文档保存到指定的输出路径。

import aspose.pdf as ap
from os import path
import sys
    
def create_link_annotation_go_to_URI_action(infile, outfile):
    document = ap.Document(infile)
    page = document.pages[1]

    link = ap.annotations.LinkAnnotation(page, ap.Rectangle(10, 580, 120, 600, True))
    link.color = ap.Color.green
    link.action = ap.annotations.GoToURIAction("https://docs.aspose.com/pdf/python")
    page.annotations.append(link)
    document.save(outfile)

Python-Net: 在 Python 中更新 PDF 链接

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

更新 LinkAnnotation 文本颜色

此示例演示如何使用 Aspose.PDF for Python 检测 PDF 第1页上的所有链接注释，然后通过将其字体颜色更改为红色来突出显示每个链接附近的文本。它使用 TextFragmentAbsorber，并在每个链接矩形周围稍微扩展的区域内查找并修改附近的文本。

此可用于：

在文档中直观地标记链接
通过强调链接内容来提升可访问性
在审阅或导出之前对 PDF 文件进行预处理

对于这些链接注释，脚本检索其矩形边界并略微扩大该区域以包含附近的文本，从而实现更广泛的视觉识别。随后，它在此扩展区域上应用 TextFragmentAbsorber，以提取位于其中的任何文本片段。通过将这些捕获的片段的字体颜色更改为红色，对周围文本进行标记，以强调和审阅。应用所有这些更新后，修改后的文档保存到输出路径，保留已高亮的注释及其关联的文本。

import aspose.pdf as ap
import sys
from os import path
from aspose.pycore import cast, is_assignable

def link_annotation_update_text_color(infile, outfile):
    document = ap.Document(infile)
    link_annotations = [
        a
        for a in document.pages[1].annotations
        if (a.annotation_type == ap.annotations.AnnotationType.LINK)
    ]

    for la in link_annotations:
        ta = ap.text.TextFragmentAbsorber()
        rect = la.rect
        rect.llx -= 2
        rect.lly -= 2
        rect.urx += 2
        rect.ury += 2
        ta.text_search_options = ap.text.TextSearchOptions(rect)
        ta.visit(document.pages[1])
        for textFragment in ta.text_fragments:
            textFragment.text_state.foreground_color = ap.Color.red

    document.save(outfile)

更新边框

脚本聚焦于文档的第一页，并过滤掉所有注释，仅选择 LINK 类型的注释——这些通常代表交互元素，例如超链接或导航触发器。对于每个此类链接注释，代码将其强制转换为 LinkAnnotation 类型，并将其颜色属性更新为红色，以视觉上突出显示，使其在其他内容中脱颖而出。所有链接注释均被修改后，更新后的文档被保存到定义的输出位置，保留新的样式。

import aspose.pdf as ap
import sys
from os import path
from aspose.pycore import cast, is_assignable

def link_annotation_update_border(infile, outfile):
    document = ap.Document(infile)
    link_annotations = [
        a
        for a in document.pages[1].annotations
        if (a.annotation_type == ap.annotations.AnnotationType.LINK)
    ]

    for la in link_annotations:
        link_annotation = cast(ap.annotations.LinkAnnotation, la)
        link_annotation.color = ap.Color.red

    document.save(outfile)

更新 Web 目标

一旦路径就绪，原始文档将使用 Aspose.PDF 库加载，使其内容可供修改。脚本随后聚焦于文档的首页，过滤掉所有注释，仅选择链接类型的注释，这类注释通常代表可点击的区域或超链接。为了避免类型错误并确保安全处理，脚本使用 is_assignable 检查每个注释，然后将其转换为相应的 LinkAnnotation 类型。如果该链接关联了 GoToURIAction，即指向网页地址，脚本会更新该 URI，以将用户重定向至 “https://www.aspose.com”. 最后，在应用所有所需更改后，修改后的文档会保存到指定的输出路径。

import aspose.pdf as ap
import sys
from os import path
from aspose.pycore import cast, is_assignable

def link_annotation_update_web_destination(infile, outfile):
    document = ap.Document(infile)
    link_annotations = [
        a
        for a in document.pages[1].annotations
        if (a.annotation_type == ap.annotations.AnnotationType.LINK)
    ]

    for la in link_annotations:
        if is_assignable(la, ap.annotations.LinkAnnotation):
            annotation = cast(ap.annotations.LinkAnnotation, la)
            if is_assignable(annotation.action, ap.annotations.GoToURIAction):
                action = cast(ap.annotations.GoToURIAction, annotation.action)
                action.uri = "https://www.aspose.com"
    document.save(outfile)

Python-Net: 在 Python 中提取 PDF 链接

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

从 PDF 文件中提取链接

此示例演示如何使用 Aspose.PDF for Python 遍历 PDF 首页上的所有链接注释。它会过滤注释以识别类型为 LinkAnnotation 的注释，安全地进行类型转换，然后打印它们的页面索引和在页面上的矩形位置。

这可用于调试、分析或对 PDF 中现有链接注释进行自动更新。

加载 PDF 文档。使用 ap.Document(path_infile) 打开文件。
访问第一页的注释。使用 document.pages[1].annotations 检索所有注释。
仅过滤 LinkAnnotation 类型。检查每个 annotation 的 annotation_type。
对 LinkAnnotation 进行类型转换和处理。使用 is_assignable() 和 cast() 确保安全访问 LinkAnnotation 属性。
打印注释详情。输出每个链接的页面索引和矩形（位置）。

import aspose.pdf as ap
import sys
from os import path
from aspose.pycore import cast, is_assignable

def extract_link_annotation(infile):

    document = ap.Document(infile)
    link_annotations = [
        a
        for a in document.pages[1].annotations
        if (a.annotation_type == ap.annotations.AnnotationType.LINK)
    ]

    for la in link_annotations:
        if is_assignable(la, ap.annotations.LinkAnnotation):
            annotation = cast(ap.annotations.LinkAnnotation, la)
            print(f"Page: {annotation.page_index}, location: {annotation.rect}")

从 PDF 文件中提取超链接

此代码演示了如何使用 Aspose.PDF for Python 从 PDF 文档的第一页提取所有 LinkAnnotation 对象，然后识别其中包含 GoToURIAction 的对象。对于每个此类链接，它会打印出页面索引和目标 URI。

这对于以下任务很有用：

审计 PDF 中的外部链接
提取文档或支持 URL
检测失效或过时的超链接

加载 PDF 文档。使用 ap.Document 打开文件。
获取第一页中的所有链接注释。过滤注释，仅保留类型为 AnnotationType.LINK 的注释。
进行类型检查并转换为 LinkAnnotation。确保每个注释确实是 LinkAnnotation 后再访问其属性。
检查链接的动作类型。过滤出使用 GoToURIAction 的链接（即指向网页 URL 的链接）。
提取并打印 URI 和页面索引。使用 .uri 获取外部链接，使用 .page_index 获取上下文。

import aspose.pdf as ap
import sys
from os import path
from aspose.pycore import cast, is_assignable

def extract_hyperlinks(infile):
    document = ap.Document(infile)
    link_annotations = [
        a
        for a in document.pages[1].annotations
        if (a.annotation_type == ap.annotations.AnnotationType.LINK)
    ]

    for la in link_annotations:
        if is_assignable(la, ap.annotations.LinkAnnotation):
            annotation = cast(ap.annotations.LinkAnnotation, la)
            if is_assignable(annotation.action, ap.annotations.GoToURIAction):
                action = cast(ap.annotations.GoToURIAction, annotation.action)
                print(f"Page {annotation.page_index}, URI:{action.uri}")

Documentation – 在 Python 中使用 PDF 链接

Python-Net: 在 Python 中创建 PDF 链接

PDF 文档中的链接

在 PDF 文件中创建 PDF 文档链接

使用 GoToRemoteAction

使用 GoToAction

应用 GoToURIAction

相关链接主题

Python-Net: 在 Python 中更新 PDF 链接

更新 LinkAnnotation 文本颜色

更新边框

更新 Web 目标

相关链接主题

Python-Net: 在 Python 中提取 PDF 链接

从 PDF 文件中提取链接

从 PDF 文件中提取超链接

相关链接主题