AddLinkToNamedDestinationA
Annotazioni, collegamenti hotspot, proprietà della pagina
Descrizione
Il suffisso A indica l'entry point DLL ANSI (char); l'interfaccia ActiveX/COM espone soltanto la forma Unicode. Il comportamento è identico a AddLinkToNamedDestination e gli argomenti stringa vengono interpretati usando la code page corrente di SetAnsiMode
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 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);Parametri
| Left | La coordinata orizzontale del bordo sinistro del rettangolo hotspot |
|---|---|
| Top | La coordinata verticale del bordo superiore del rettangolo hotspot |
| Width | La larghezza del rettangolo hotspot |
| Height | L'altezza del rettangolo hotspot |
| DestName | Destinazione denominata a cui passare. Il nome deve esistere già nell'albero dei nomi del documento, normalmente tramite NewNamedDestination |
| Options | Maschera 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
| 0 | DestName era vuoto oppure non è stato possibile creare il collegamento |
|---|---|
| 1 | Il 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