Documentation – Trabalhar com links PDF em Python

Python-Net: Criar links PDF em Python

Tue, 19 May 2026 00:00:00 +0000

Links em Documentos PDF

De acordo com a especificação PDF 1.7 (ISO 32000-1:2008), uma Link annotation pode acionar vários tipos de ações que definem o que acontece quando a anotação é ativada. Aqui estão as principais ações suportadas:

GoTo – Navega para um destino dentro do mesmo documento.
GoToR – Salta para um destino em outro arquivo PDF (go-to remoto).
URI – Abre um identificador uniforme de recurso, normalmente um link da web.
Launch – Lança um aplicativo ou abre um arquivo (dependente da plataforma e frequentemente restrito por questões de segurança).
Named – Executa uma ação predefinida, como ir para a próxima página ou imprimir o documento.
JavaScript – Executa código JavaScript incorporado (usado com cautela devido a preocupações de segurança).
SubmitForm – Envia os dados do formulário para um URL especificado.
ResetForm – Reseta os campos do formulário para seus valores padrão.
ImportData – Importa dados para o documento a partir de um arquivo externo.

Ao adicionar um link para um aplicativo em um documento, é possível vincular aplicativos a partir de um documento. Isso é útil quando você deseja que os leitores realizem uma certa ação em um ponto específico de um tutorial, por exemplo, ou para criar um documento rico em recursos.

Para criar um link de aplicativo com ‘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)

Criar link de Document PDF em um arquivo PDF

Usando GoToRemoteAction

Este trecho de código demonstra como adicionar uma anotação de link a uma página específica de um documento PDF usando uma biblioteca PDF para Python.

Abrir o documento PDF
Selecione a segunda página do documento (índice 1)
Criar uma anotação de link:
Posicionado nas coordenadas (10, 580, 120, 600)
Colorido em verde
Links para ‘sample.pdf’ na sua primeira página
Adicionar a anotação de link à página
Salvar o documento modificado no caminho do arquivo de saída

Para criar um link de documento PDF usando ‘GoToRemoteAction’:

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)

Usando GoToAction

Este código demonstra como adicionar uma anotação de link a uma página específica de um documento PDF usando Aspose.PDF for Python. O link aparece como um retângulo verde com borda tracejada e permite ao usuário navegar para outra página dentro do mesmo PDF. Para criar um link de documento PDF usando ‘GoToAction’:

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)

Aplicando GoToURIAction

O próximo exemplo demonstra como adicionar uma anotação de link a um documento PDF usando Aspose.PDF for Python. O link aparece como uma área verde clicável na primeira página e, quando clicado, abre a documentação do Aspose.PDF for Python em um navegador da web via uma GoToURIAction.

Essa funcionalidade é útil para incorporar referências externas úteis, documentação ou links de suporte diretamente em seus PDFs.

Carregue o Documento PDF. Abra o arquivo PDF existente usando ap.Document.
Acesse a Primeira Página. Use document.pages[1] para acessar a primeira página (Aspose usa indexação baseada em 1).
Crie uma Anotação de Link. Crie um objeto LinkAnnotation e especifique a área retangular clicável usando ap.Rectangle.
Defina a aparência da anotação. Defina a cor da anotação para verde usando link.color = ap.Color.green.
Atribua uma ação URI. Use GoToURIAction para vincular a anotação a um URL externo.
Adicione a anotação à página. Anexe a anotação de link configurada à coleção de anotações da primeira página.
Salve o documento modificado. Salve o documento PDF atualizado no caminho de saída especificado.

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)

Tópicos de Links Relacionados

Python-Net: Atualizar links PDF em Python

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

Atualizar a Cor do Texto da LinkAnnotation

Este exemplo mostra como detectar todas as anotações de link na primeira página de um PDF usando Aspose.PDF for Python, então destacar o texto próximo a cada link alterando a cor da fonte para vermelho. Ele usa TextFragmentAbsorber com uma área ligeiramente expandida ao redor de cada retângulo de link para encontrar e modificar o texto próximo.

Isso pode ser usado para:

Marcar visualmente links em um documento
Aprimorar a acessibilidade enfatizando o conteúdo vinculado
Pré-processamento de arquivos PDF antes da revisão ou exportação

Para cada uma dessas anotações de link, o script recupera seu limite retangular e expande ligeiramente essa região para incluir texto próximo, permitindo uma identificação visual mais ampla. Em seguida, aplica um TextFragmentAbsorber sobre essa área expandida para extrair quaisquer fragmentos de texto localizados nela. Esses fragmentos capturados são modificados alterando a cor da fonte para vermelho, marcando efetivamente o texto ao redor para ênfase e revisão. Após aplicar todas essas atualizações, o documento modificado é salvo no caminho de saída, preservando as anotações destacadas e seu texto associado.

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)

Atualizar borda

O script concentra-se na primeira página do documento e filtra todas as anotações, selecionando apenas aquelas do tipo LINK—geralmente representam elementos interativos, como hyperlinks ou gatilhos de navegação. Para cada uma dessas anotações de link, o código as converte para o tipo LinkAnnotation e atualiza sua propriedade de cor para vermelho, destacando-as visualmente para se sobressair ao restante do conteúdo. Após todas as anotações de link terem sido modificadas, o documento atualizado é salvo no local de saída definido, preservando o novo estilo.

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)

Atualizar Destino da Web

Uma vez que os caminhos estejam configurados, o documento original é carregado usando a biblioteca Aspose.PDF, tornando seu conteúdo acessível para modificação. O script então foca na primeira página do documento, filtrando todas as anotações e selecionando apenas aquelas do tipo link, que tipicamente representam áreas clicáveis ou hiperlinks. Para evitar erros de tipo e garantir um manuseio seguro, cada anotação é verificada com is_assignable e então convertida para o tipo adequado LinkAnnotation. Se o link estiver associado a uma GoToURIAction, significando que aponta para um endereço web, o script atualiza esse URI para redirecionar os usuários para “https://www.aspose.com”. Finalmente, depois que todas as alterações desejadas foram aplicadas, o documento modificado é salvo no caminho de saída especificado.

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)

Tópicos de Links Relacionados

Python-Net: Extrair Links PDF em Python

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

Extrair Links do Arquivo PDF

Este exemplo demonstra como iterar por todas as anotações de link na primeira página de um PDF usando Aspose.PDF for Python. Ele filtra as anotações para identificar aquelas do tipo LinkAnnotation, faz cast seguro delas e, em seguida, imprime o índice da página e a posição retangular na página.

Isso pode ser usado para depuração, análises ou atualizações automatizadas das anotações de link existentes em um PDF.

Carregue o documento PDF. Use ap.Document(path_infile) para abrir o arquivo.
Acesse as anotações da primeira página. Use document.pages[1].annotations para recuperar todas as anotações.
Filtre apenas os tipos LinkAnnotation. Verifique o annotation_type de cada anotação.
Faça cast e processe as LinkAnnotations. Use is_assignable() e cast() para garantir acesso seguro às propriedades de LinkAnnotation.
Imprima detalhes da anotação. Exiba o índice da página e o retângulo (localização) de cada link.

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

Extrair HyperLinks do Arquivo PDF

Este código demonstra como extrair todos os objetos LinkAnnotation da primeira página de um documento PDF usando Aspose.PDF for Python, e então identificar aqueles que contêm um GoToURIAction. Para cada um desses links, ele imprime o índice da página e o URI de destino.

Isso é útil para tarefas como:

Auditar links externos em um PDF
Extrair URLs de documentação ou suporte
Detectar hiperlinks quebrados ou desatualizados

Carregar o documento PDF. Abrir o arquivo usando ap.Document.
Obter todas as anotações de link da primeira página. Filtrar anotações para incluir apenas aquelas com o tipo AnnotationType.LINK.
Verifique o tipo e faça cast para LinkAnnotation. Certifique‑se de que cada anotação é realmente uma LinkAnnotation antes de acessar suas propriedades.
Verifique o tipo de ação do link. Filtre os links que utilizam um GoToURIAction (ou seja, links para um URL da web).
Extraia e imprima o URI e o índice da página. Use .uri para obter o link externo e .page_index para obter o contexto.

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