Documentation – Ссылки и навигация

Python-Net: Добавить ссылку на приложение

Fri, 20 Mar 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: Добавить пользовательскую ссылку действия

Fri, 20 Mar 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_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‑ссылку

Fri, 20 Mar 2026 00:00:00 +0000

JavaScript‑ссылки в PDF позволяют реализовать интерактивный функционал, такой как отображение предупреждений, выполнение вычислений или динамическое изменение содержимого документа. Используя 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: Добавить локальную ссылку

Fri, 20 Mar 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‑документ

Fri, 20 Mar 2026 00:00:00 +0000

Ссылки в 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: Добавить веб‑ссылку

Fri, 20 Mar 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: Извлечение ссылок

Fri, 20 Mar 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")