AddLinkToNamedDestination

Annotazioni, collegamenti hotspot, proprietà della pagina

Descrizione

Aggiunge alla pagina selezionata un rettangolo sensibile selezionabile che passa a una destinazione denominata nello stesso documento PDF. Usare prima NewDestination e NewNamedDestination per registrare la destinazione, quindi creare aree sensibili che facciano riferimento al nome stabile della destinazione anziché duplicare un numero di pagina e un array di destinazione

Usare la funzione SetAnnotBorderColor per cambiare il colore del bordo dell'area sensibile

Sintassi

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);

Parametri

LeftLa coordinata orizzontale del bordo sinistro del rettangolo hotspot
TopLa coordinata verticale del bordo superiore del rettangolo hotspot
WidthLa larghezza del rettangolo hotspot
HeightL'altezza del rettangolo hotspot
DestNameDestinazione denominata a cui passare. Il nome deve esistere già nell'albero dei nomi del documento, normalmente tramite NewNamedDestination
OptionsMaschera di bit che controlla l'aspetto del collegamento. Bit 0 (valore 1): disegna un bordo intorno al rettangolo sensibile al clic. I bit 1–3 selezionano la modalità di evidenziazione al clic (2 = Invert, 4 = Outline, 8 = Push); se non è impostato alcun bit di evidenziazione, viene usato Invert per impostazione predefinita

Valori restituiti

0DestName era vuoto oppure non è stato possibile creare il collegamento
1Il collegamento alla destinazione con nome è stato aggiunto alla pagina selezionata

Note

L'annotazione scrive un'azione GoTo verso la destinazione denominata, mantenendo stabili le aree sensibili quando le pagine vengono inserite o spostate