Documentation – Python で PDF リンクを操作する

Python-Net: Python で PDF リンクを作成

Tue, 09 Jun 2026 00:00:00 +0000

PDF ドキュメント内のリンク

PDF 1.7仕様（ISO 32000-1:2008）によると、リンクアノテーションは、アノテーションがアクティブになったときに何が起こるかを定義するいくつかのタイプのアクションをトリガーできます。サポートされている主なアクションは次のとおりです。

GoTo — 同じ文書内の宛先に移動します。
GoTor — 別の PDF ファイル内の目的地にジャンプします (リモートアクセス)。
URI — 統一リソース識別子 (通常は Web リンク) を開きます。
Launch — アプリケーションを起動するか、ファイルを開きます (プラットフォームによって異なり、セキュリティ上の理由で制限されている場合が多いです)。
名前付き — 次のページへの移動や文書の印刷など、定義済みのアクションを実行します。
JavaScript — 埋め込まれた JavaScript コードを実行します (セキュリティ上の懸念から注意して使用してください)。
送信フォーム — 指定した 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 ドキュメントリンクを作成

「リモートに移動」操作を使用する

このコードスニペットは、Python PDF ライブラリを使用して PDF ドキュメントの特定のページにリンク注釈を追加する方法を示しています。

PDF ドキュメントを開く
文書の 2 ページ目を選択 (インデックス 1)
リンク注釈の作成:
座標値 (10、580、120、600) で配置されています
カラーグリーン
最初のページにある「sample.pdf」へのリンク
リンク注釈をページに追加する
変更したドキュメントを出力ファイルパスに保存します

「リモートアクションに移動」を使用して 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)

「Go To」アクションを使用する

このコードは、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)

GoTouriアクションの適用

次の例は、Aspose.PDF for Python を使用して PDF ドキュメントにリンクアノテーションを追加する方法を示しています。リンクは最初のページに緑色のクリック可能な領域として表示され、クリックすると、GoTouriAction を使用して Aspose.PDF for Python のドキュメントが Web ブラウザーで開きます。

この機能は、役立つ外部参考資料、ドキュメント、またはサポートリンクをPDF内に直接埋め込むのに便利です。

PDF ドキュメントをロードします。AP.Document を使用して既存の PDF ファイルを開きます。
最初のページにアクセスします。document.pages [1] を使用して最初のページにアクセスします (Aspose は 1 から始まるインデックスを使用します)。
リンク注釈を作成します。LinkNotation オブジェクトを作成し、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 リンクを更新する方法

Tue, 09 Jun 2026 00:00:00 +0000

リンク注釈のテキスト色を更新

この例は、Aspose.PDF for Python を使用して PDF の最初のページのすべてのリンク注釈を検出し、フォントの色を赤に変更して各リンクの近くのテキストを強調表示する方法を示しています。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)

境界を更新

このスクリプトはドキュメントの最初のページに焦点を当て、すべての注釈を除外してリンクタイプの注釈のみを選択します。これらは通常、ハイパーリンクやナビゲーショントリガーなどのインタラクティブな要素を表します。これらのリンク注釈はそれぞれ 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 でチェックされ、適切な LinkNotation タイプにキャストされます。リンクが GoTouriAction に関連付けられている場合、つまり Web アドレスを指している場合、スクリプトはその 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 リンクを抽出

Tue, 09 Jun 2026 00:00:00 +0000

PDF ファイルからリンクを抽出

この例は、Aspose.PDF for Python を使用して PDF の最初のページのすべてのリンク注釈を繰り返し処理する方法を示しています。注釈をフィルタリングして LinkNotation 型の注釈を識別し、安全にキャストしてから、ページインデックスとページ上の長方形の位置を出力します。

これは、PDF 内の既存のリンク注釈のデバッグ、分析、または自動更新に使用できます。

PDF ドキュメントをロードします。AP.Document (パス_infile) を使用してファイルを開きます。
最初のページから注釈にアクセスします。すべてのアノテーションを取得するには document.pages [1] .annotations を使用してください。
リンク注釈タイプのみのフィルタ。各アノテーションの annotation_type を確認してください。
リンクアノテーションをキャストして処理します。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 タイプのアノテーションのみが含まれるようにします。
タイプチェックを行い、LinkNotationにキャストします。プロパティにアクセスする前に、各アノテーションが本当に LinkNotation であることを確認してください。
リンクのアクションタイプを確認してください。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 ドキュメントリンクを作成

「リモートに移動」操作を使用する

「Go To」アクションを使用する

GoTouriアクションの適用

関連リンクトピックス

Python-Net: Python で PDF リンクを更新する方法

リンク注釈のテキスト色を更新

境界を更新

Web デスティネーションを更新

関連リンクトピックス

Python-Net: Python で PDF リンクを抽出

PDF ファイルからリンクを抽出

PDF ファイルからハイパーリンクを抽出

関連リンクトピックス