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

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
NamedActionTypeSeleziona 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
OptionsMaschera 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