AddLinkToNamedDestination
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 salta para um destino nomeado no mesmo documento PDF. Use NewDestination e NewNamedDestination para registrar o destino primeiro e depois crie hotspots que referenciem o nome estável do destino em vez de duplicar um número de página e um array de destino
Use a função SetAnnotBorderColor para alterar a cor da borda do hotspot
Sintaxe
Delphi
Function TPDFlib.AddLinkToNamedDestination(Left, Top, Width, Height: Double; Const DestName: WideString; Options: Integer): Integer;DLL
int DLAddLinkToNamedDestination(int InstanceID, double Left, double Top, double Width, double Height, const wchar_t * DestName, 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 |
| DestName | O destino nomeado para onde pular. O nome já deve existir na name tree do documento, normalmente via NewNamedDestination |
| Options | Máscara de bits que controla a aparência do link. Bit 0 (valor 1): desenhar uma borda ao redor do retângulo da zona ativa. Os bits 1–3 selecionam o modo de realce no clique (2 = Invert, 4 = Outline, 8 = Push); quando nenhum bit de realce está definido, Invert é usado como padrão |
Valores retornados
| 0 | DestName estava vazio ou o link não pôde ser criado |
|---|---|
| 1 | O link de destino nomeado foi adicionado à página selecionada |
Observações
A anotação de link grava uma ação GoTo cujo destino é a string do destino nomeado. Isso mantém os hotspots estáveis quando páginas são inseridas ou movidas depois que o destino nomeado foi criado