AddLinkToNamedAction
Anotações e ligações de zonas interativas, propriedades da página
Descrição
Adiciona à página selecionada um retângulo de zona interativa clicável que aciona uma ação PDF designada quando é ativado. As ações designadas são comandos de navegação controlados pelo visualizador e definidos na ISO 32000-1 §12.6.4.11, Tabela 194. Os quatro nomes padrão suportados são NextPage, PrevPage, FirstPage e LastPage. Ao contrário de AddLinkToPage, não é necessário um número explícito da página de destino — o visualizador interpreta o comando durante a execução
Utilização habitual: botões de navegação (Next / Previous / Home / End) num cabeçalho ou rodapé, em que o destino é relativo à página que o visualizador apresenta atualmente
Utilize a função SetAnnotBorderColor para alterar a cor do contorno da área sensível
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 margem esquerda do retângulo da área sensível |
|---|---|
| Top | A coordenada vertical da margem superior do retângulo da zona ativa |
| Width | A largura do retângulo da área sensível |
| Height | A altura do retângulo da área sensível |
| NamedActionType | Seleciona a ação nomeada a acionar: 0 = NextPage, 1 = PrevPage, 2 = FirstPage, 3 = LastPage. Os valores fora deste intervalo recorrem a NextPage, para que o gerador emita sempre um nome /N em conformidade com a especificação |
| Options | Máscara de bits que controla o aspeto da ligação. Bit 0 (valor 1): desenha um contorno em torno do retângulo interativo. Os bits 1–3 selecionam o modo de realce ao clicar (2 = Invert, 4 = Outline, 8 = Push); quando não está definido nenhum bit de realce, Invert é utilizado por predefinição. Segue a mesma convenção de AddLinkToWeb / AddLinkToPage |
Observações
A anotação é compatível com PDF/A porque não é referenciado qualquer recurso externo. É necessário PDF 1.1 ou posterior