AddLinkToNamedAction
Annotazioni, collegamenti hotspot, proprietà della pagina
Descrizione
Aggiunge un'area selezionabile che attiva un'azione denominata PDF secondo ISO 32000-1 §12.6.4.11, Tabella 194. Nomi: NextPage, PrevPage, FirstPage, LastPage. A differenza di AddLinkToPage, il viewer interpreta il comando a runtime — senza numero pagina
Uso tipico: pulsanti Next / Previous / Home / End in intestazione o piè di pagina, con destinazione relativa alla pagina mostrata dal visualizzatore.
Usare la funzione SetAnnotBorderColor per cambiare il colore del bordo dell'area sensibile
Sintassi
Delphi
Function TPDFlib.AddLinkToNamedAction(Left, Top, Width, Height: Double; NamedActionType: Integer; Options: Integer): Integer;
DLL
int DLAddLinkToNamedAction(int InstanceID, double Left, double Top, double Width, double Height, int NamedActionType, 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 |
| NamedActionType | Seleziona l'azione denominata da attivare: 0 = NextPage, 1 = PrevPage, 2 = FirstPage, 3 = LastPage. I valori esterni a questo intervallo usano NextPage come ripiego, così il writer emette sempre un nome /N conforme alla specifica |
| Options | Maschera di bit che controlla l'aspetto del collegamento. Bit 0 (valore 1): disegna un bordo attorno al rettangolo dell'area sensibile. I bit 1–3 selezionano la modalità di evidenziazione al clic (2 = Invert, 4 = Outline, 8 = Push); quando non è impostato alcun bit di evidenziazione, viene usato Invert per impostazione predefinita. Segue la stessa convenzione di AddLinkToWeb / AddLinkToPage |
Note
L'annotazione è compatibile PDF/A perché non referenzia risorse esterne. Richiede PDF 1.1 o successivo