AddRelativeLinkToFileEx

Annotazioni, collegamenti hotspot

Descrizione

Aggiunge alla pagina selezionata un rettangolo sensibile al clic che si collega, mediante un percorso relativo, a una pagina e una posizione specifiche di un altro documento PDF. Usare la funzione SetAnnotBorderColor per cambiare il colore del bordo dell'area selezionabile

Il collegamento al documento di destinazione avviene soltanto tramite il nome file. Poiché le dimensioni della pagina del documento di destinazione non sono note, i parametri DestLeft, DestTop, DestRight e DestBottom vengono sempre specificati in punti misurati dall'angolo inferiore sinistro del MediaBox della pagina di destinazione's

Sintassi

Delphi

Function TPDFlib.AddRelativeLinkToFileEx(Left, Top, Width, Height: Double; Const FileName: WideString; DestPage: Integer; NewWindow, Options, Zoom, DestType: Integer; DestLeft, DestTop, DestRight, DestBottom: Double): Integer;

ActiveX

Function PDFlib::AddRelativeLinkToFileEx(Left As Double, Top As Double, Width As Double, Height As Double, FileName As String, DestPage As Long, NewWindow As Long, Options As Long, Zoom As Long, DestType As Long, DestLeft As Double, DestTop As Double, DestRight As Double, DestBottom As Double) As Long

DLL

int DLAddRelativeLinkToFileEx(int InstanceID, double Left, double Top, double Width, double Height, const wchar_t * FileName, int DestPage, int NewWindow, int Options, int Zoom, int DestType, double DestLeft, double DestTop, double DestRight, double DestBottom);

Parametri

Left

La coordinata orizzontale del bordo sinistro del rettangolo dell'area sensibile

Top

La coordinata verticale del bordo superiore del rettangolo dell'area sensibile

Width

La larghezza del rettangolo hotspot

Height

L'altezza del rettangolo hotspot

FileName

Percorso assoluto completo e nome del PDF da collegare, convertito in percorso relativo

DestPage

La pagina del documento di destinazione a cui collegarsi

NewWindow

0 = Chiude il documento corrente e quindi apre il nuovo documento

1 = Apre il documento corrente in una nuova finestra

Options

Specifica l'aspetto del collegamento:

0 = Nessun bordo

1 = Disegna un bordo

Percentuale zoom per l'oggetto destinazione, da 0 a 6400. Usata soltanto per DestType = 1; impostare 0 per gli altri DestTypes.

Zoom

DestType

1 = "XYZ" - la pagina viene posizionata nel punto Left e Top. Zoom specifica la percentuale di ingrandimento.

2 = "Fit" - l'intera pagina viene ingrandita per adattarsi alla finestra. Nessuno degli altri parametri viene usato e tutti devono essere impostati su zero.

3 = "FitH" - la pagina viene ingrandita affinché ne sia visibile l'intera larghezza. L'altezza della pagina può essere maggiore o minore di quella della finestra. La pagina viene posizionata alla posizione verticale specificata dal parametro Top

4 = "FitV" - la pagina viene ingrandita affinché sia visibile per intero in altezza. La larghezza della pagina può essere maggiore o minore di quella della finestra. La pagina viene collocata nella posizione orizzontale specificata dal parametro Left

5 = "FitR" - ingrandisce la pagina affinché sia visibile un rettangolo definito da Left, Top, Right e Bottom.

6 = "FitB" - la pagina viene ingrandita affinché il suo riquadro di delimitazione' sia visibile

7 = "FitBH" - posiziona verticalmente con Top e adatta la larghezza del riquadro della pagina's alla finestra

8 = "FitBV" - la pagina viene posizionata alla coordinata orizzontale indicata da Left e ingrandita quanto basta per adattare l'intera altezza del riquadro di delimitazione alla finestra

DestLeft

La posizione orizzontale usata da DestType = 1, 4, 5 e 8

DestTop

La posizione verticale usata da DestType = 1, 3, 5 e 7

DestRight

Posizione orizzontale del bordo destro del rettangolo. Usata da DestType = 5

DestBottom

Posizione orizzontale della parte inferiore del rettangolo. Usata da DestType = 5

int NewWindow, int Options, int Zoom, int DestType, double DestLeft, double DestTop, double DestRight, double DestBottom);

Height: Double; FileName: WideString; DestPage, NewWindow, Options, Zoom, DestType: Integer; DestLeft, DestTop, DestRight,