AddLinkToNamedDestinationA
Anotações e links de zona ativa, Propriedades da página
Descrição
O A final indica o ponto de entrada DLL ANSI (char); a superfície ActiveX/COM expõe apenas a forma Unicode. O comportamento é idêntico ao de AddLinkToNamedDestination e os argumentos string são interpretados usando a página de código atual de SetAnsiMode
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 DLAddLinkToNamedDestinationA(InstanceID: Integer; Left, Top, Width, Height: Double; DestName: PAnsiChar; Options: Integer): Integer;DLL
int DLAddLinkToNamedDestinationA(int InstanceID, double Left, double Top, double Width, double Height, const char * 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