AddLinkToNamedDestinationA
Anotações e ligações de zonas interativas, propriedades da página
Descrição
O A final indica o ponto de entrada ANSI (char) da DLL; a interface ActiveX/COM expõe apenas a forma Unicode. O comportamento é idêntico ao de AddLinkToNamedDestination e os argumentos de cadeia são interpretados com a página de códigos atual de SetAnsiMode
Adiciona à página selecionada um retângulo de área interativa que salta para um destino nomeado no mesmo documento PDF. Utilize NewDestination e NewNamedDestination para registar primeiro o destino e, em seguida, crie áreas interativas que referenciem o nome de destino estável em vez de duplicarem um número de página e uma matriz de destino
Utilize a função SetAnnotBorderColor para alterar a cor do contorno da área sensível
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 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 |
| DestName | O destino com nome para o qual saltar. O nome já deve existir na árvore de nomes do documento, normalmente através de NewNamedDestination |
| Options | Máscara de bits que controla a aparência da ligação. Bit 0 (valor 1): desenhar um contorno em redor do retângulo da área sensível. Os bits 1–3 selecionam o modo de realce ao clicar (2 = Inverter, 4 = Contorno, 8 = Premir); quando nenhum bit de realce está definido, Inverter é utilizado como predefinição |
Valores devolvidos
| 0 | DestName estava vazio ou não foi possível criar a ligação |
|---|---|
| 1 | A ligação de destino com nome foi adicionada à página selecionada |
Observações
A anotação de ligação escreve uma ação GoTo cujo destino é a cadeia de destino designada. Isto mantém as zonas interativas estáveis quando são inseridas ou movidas páginas depois de criar o destino designado