AddRelativeLinkToFileEx

Annotations et liens de zone réactive

Description

Ajoute à la page sélectionnée une zone rectangulaire cliquable qui renvoie, par un chemin relatif, vers une page et une position précises d’un autre document PDF. Utilisez la fonction SetAnnotBorderColor pour modifier la couleur de sa bordure

Le lien vers le document cible utilise seulement le nom de fichier. Ses dimensions de page sont donc inconnues, et DestLeft, DestTop, DestRight et DestBottom sont toujours indiqués en points mesurés depuis le coin inférieur gauche de la MediaBox d'une page de destination

Syntaxe

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

Paramètres

Left

Coordonnée horizontale du bord gauche du rectangle de la zone active

Top

Coordonnée verticale du bord supérieur du rectangle de la zone active

Width

Largeur du rectangle de la zone active

Height

Hauteur du rectangle de la zone active

FileName

Le chemin absolu complet et le nom du document PDF cible du lien ; il sera converti en chemin relatif

DestPage

Page du document de destination vers laquelle créer le lien

NewWindow

0 = fermer le document actuel puis ouvrir le nouveau document

1 = ouvrir le document actuel dans une nouvelle fenêtre

Options

Indique l’apparence du lien :

0 = Aucune bordure

1 = Dessiner une bordure

Pourcentage de zoom de l'objet destination, valeurs valides de 0 à 6400. Utilisé uniquement avec DestType = 1 ; définissez-le sur 0 pour les autres DestTypes

Zoom

DestType

1 = "XYZ" - la page cible est placée au point indiqué par Left et Top. Zoom indique le pourcentage d'agrandissement

2 = "Fit" - toute la page est agrandie pour tenir dans la fenêtre. Aucun autre paramètre n'est utilisé et tous doivent être définis sur zéro

3 = "FitH" - la page est agrandie de manière à afficher toute sa largeur. Sa hauteur peut être supérieure ou inférieure à celle de la fenêtre. La page est placée à la position verticale indiquée par le paramètre Top

4 = "FitV" - la page est agrandie de manière à afficher toute sa hauteur. Sa largeur peut être supérieure ou inférieure à celle de la fenêtre. La page est placée à la position horizontale indiquée par le paramètre Left

5 = "FitR" - la page est agrandie afin qu'un rectangle soit visible. Left, Top, Right et Bottom définissent la zone rectangulaire

6 = "FitB" - la page est agrandie de façon que son cadre englobant soit visible, tel qu'il est défini

7 = "FitBH" - la page est positionnée verticalement selon Top et agrandie afin que toute la largeur de sa boîte englobante soit visible'

8 = "FitBV" - la page est placée horizontalement selon Left et agrandie juste assez pour faire tenir toute la hauteur de la boîte englobante dans la fenêtre

DestLeft

Position horizontale utilisée par DestType = 1, 4, 5 et 8

DestTop

Position verticale utilisée par DestType = 1, 3, 5 et 7

DestRight

La position horizontale du bord droit du rectangle Utilisée par DestType = 5

DestBottom

Position horizontale du bas du rectangle Utilisée par 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,