Documentation – Links e Navegação

Python-Net: Adicionar Link de Aplicativo

Mon, 18 May 2026 00:00:00 +0000

PDF pode incluir elementos interativos, como links que iniciam aplicativos externos. Usando PdfContentEditor, você pode definir uma região retangular em uma página que, quando clicada, abre um arquivo executável específico.

Crie uma instância de PdfContentEditor.
Vincule o documento PDF de entrada.
Defina uma área retangular para o link clicável.
Especifique o caminho da aplicação a ser lançada.
Defina a cor do link.
Salve o documento PDF atualizado.

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: Adicionar Link de Ação Personalizada

Mon, 18 May 2026 00:00:00 +0000

Links de ação personalizados permitem definir áreas interativas em um PDF que podem disparar ações específicas quando clicadas, como executar scripts, navegar entre páginas ou executar comandos específicos de aplicativos. Usando PdfContentEditor, você pode criar um link de ação personalizada especificando a página, o retângulo, a cor e as ações.

Crie uma instância de PdfContentEditor.
Vincule o documento PDF de entrada.
Defina um retângulo para o link clicável.
Especifique o número da página e a cor do link.
Atribua ações personalizadas (vazio neste exemplo).
Salve o documento PDF atualizado.

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: Adicionar link JavaScript

Mon, 18 May 2026 00:00:00 +0000

Links JavaScript em PDFs permitem funcionalidades interativas, como exibir alertas, realizar cálculos ou modificar dinamicamente o conteúdo do documento. Usando PdfContentEditor, você pode definir um retângulo clicável em uma página e associá-lo a um código JavaScript personalizado.

Crie uma instância de PdfContentEditor.
Vincule o documento PDF de entrada.
Defina um retângulo para o link JavaScript clicável.
Especifique o número da página e a cor do link.
Atribua o código JavaScript a ser executado ao clicar.
Salve o documento PDF atualizado.

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: Adicionar link local

Mon, 18 May 2026 00:00:00 +0000

Links locais em PDFs permitem navegação rápida entre páginas dentro do mesmo documento. Usando PdfContentEditor, você pode definir um retângulo clicável que vincula uma página a outra, melhorando a usabilidade e a navegação do documento.

Crie uma instância de PdfContentEditor.
Vincule o documento PDF de entrada.
Defina um retângulo para o link local clicável.
Especifique a página de origem e a página de destino.
Defina a cor do link.
Salve o documento PDF atualizado.

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: Adicionar link de documento PDF

Mon, 18 May 2026 00:00:00 +0000

Links de documentos PDF permitem que os usuários naveguem de um PDF para outro de forma contínua. Usando PdfContentEditor, você pode definir um retângulo clicável que vincula a uma página em um arquivo PDF diferente, tornando seus documentos interativos e conectados.

Crie uma instância de PdfContentEditor.
Vincule o documento PDF de entrada.
Defina um retângulo para o link clicável.
Specifie o arquivo PDF vinculado, a página de origem e a página de destino.
Defina a cor do link.
Salve o documento PDF atualizado.

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: Adicionar link da Web

Mon, 18 May 2026 00:00:00 +0000

Links da Web em PDFs permitem que os usuários naveguem diretamente para recursos online, sites ou documentação. Usando PdfContentEditor, você pode definir uma área retangular em uma página PDF que, ao ser clicada, abre um URL no navegador padrão.

Crie uma instância de PdfContentEditor.
Vincule o documento PDF de entrada.
Defina um retângulo para o link da web clicável.
Especifique o URL, número da página e cor do link.
Salve o documento PDF atualizado.

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: Extrair Links

Mon, 18 May 2026 00:00:00 +0000

Os PDFs frequentemente contêm elementos interativos, como links da web, links de documento e ações personalizadas. Usando PdfContentEditor, você pode extrair programaticamente todas as anotações de link de um PDF. Isso permite que você inspecione ou processe os links, por exemplo, para validar URLs ou analisar padrões de navegação em um documento.

Crie uma instância de PdfContentEditor.
Vincule o documento PDF de entrada.
Extrair todos os links usando ’extract_link()'.
Iterar pelos links extraídos.
Verificar se um link é um LinkAnnotation e se sua ação é um GoToURIAction.
Imprimir as coordenadas do retângulo e a URI.
Exibir uma mensagem se nenhum link for encontrado.

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")