AddLinkToNamedAction
Anotações e links de zona ativa, Propriedades da página
Descrição
Adiciona à página selecionada um retângulo de hotspot clicável que dispara uma ação nomeada do PDF quando ativado. Ações nomeadas são comandos de navegação controlados pelo visualizador, definidos na ISO 32000-1 §12.6.4.11, Tabela 194. Os quatro nomes padrão suportados são NextPage, PrevPage, FirstPage e LastPage. Diferente de AddLinkToPage, nenhum número de página de destino explícito é necessário — o visualizador interpreta o comando em tempo de execução
Uso típico: botões de navegação (Avançar / Anterior / Início / Fim) no cabeçalho ou rodapé de uma página, em que o destino é relativo à página que o visualizador está exibindo no momento
Use a função SetAnnotBorderColor para alterar a cor da borda do hotspot
Sintaxe
Delphi
Function TPDFlib.AddLinkToNamedAction(Left, Top, Width, Height: Double; NamedActionType: Integer; Options: Integer): Integer;DLL
int DLAddLinkToNamedAction(int InstanceID, double Left, double Top, double Width, double Height, int NamedActionType, int Options);Parâmetros
| Left | A coordenada horizontal da borda esquerda do retângulo de hotspot |
|---|---|
| Top | A coordenada vertical da borda superior do retângulo de hotspot |
| Width | A largura do retângulo de hotspot |
| Height | A altura do retângulo de hotspot |
| NamedActionType | Seleciona a ação nomeada a disparar: 0 = NextPage, 1 = PrevPage, 2 = FirstPage, 3 = LastPage. Valores fora dessa faixa caem em NextPage, para que o writer sempre emita um nome /N conforme a especificação. |
| Options | Máscara de bits que controla a aparência do link. Bit 0 (valor 1): desenha uma borda ao redor do retângulo de área clicável. Os bits 1–3 selecionam o modo de realce ao clicar (2 = Invert, 4 = Outline, 8 = Push); quando nenhum bit de realce é definido, Invert é usado como padrão. Mesma convenção de AddLinkToWeb / AddLinkToPage |
Observações
A anotação é compatível com PDF/A porque nenhum recurso externo é referenciado. É necessário PDF 1.1 ou posterior