AddRelativeLinkToFileEx

Annotaties en hotspotkoppelingen

Beschrijving

Voegt een klikbare hotspotrechthoek toe aan de geselecteerde pagina die via een relatief pad naar een specifieke pagina en positie in een ander PDF-document verwijst. Gebruik de functie SetAnnotBorderColor om de kleur van de hotspotrand te wijzigen

De verwijzing naar het doeldocument verloopt alleen via de bestandsnaam. De paginafmetingen van het doeldocument zijn dus onbekend, waardoor de parameters DestLeft, DestTop, DestRight en DestBottom altijd in punten worden opgegeven, gemeten vanaf de linkerbenedenhoek van de MediaBox van de doelpagina

Syntaxis

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

Syntaxis

Left

De horizontale coördinaat van de linkerrand van de hotspotrechthoek

Top

De verticale coördinaat van de bovenrand van de hotspotrechthoek

Width

De breedte van de hotspotrechthoek

Height

De hoogte van de hotspotrechthoek

FileName

Het volledige absolute pad en de bestandsnaam van het PDF-document waarnaar wordt verwezen; dit wordt naar een relatief pad geconverteerd

DestPage

De pagina in het doeldocument waarnaar wordt verwezen

NewWindow

0 = Het huidige document sluiten en daarna het nieuwe document openen

1 = Het huidige document in een nieuw venster openen

Options

Geeft het uiterlijk van de link op:

0 = No border

1 = Draw a border

Het zoomepercentage dat voor het bestemmingsobject wordt gebruikt, geldige waarden van 0 tot 6400. Alleen gebruikt bij DestType = 1; zet deze op 0 bij andere DestTypes

Zoom

DestType

1 = "XYZ" - de doelpagina wordt gepositioneerd op het punt dat door de parameters Left en Top wordt opgegeven. De parameter Zoom geeft het zoomepercentage

2 = "Fit" - de hele pagina wordt ingezoomd zodat deze in het venster past. De overige parameters worden niet gebruikt en moeten op nul worden gezet

3 = "FitH" - de pagina wordt ingezoomd zodat de volledige breedte zichtbaar is. De hoogte van de pagina kan groter of kleiner zijn dan de hoogte van het venster. De pagina wordt op de verticale positie geplaatst die de parameter Top opgeeft

4 = "FitV" - de pagina wordt ingezoomd zodat de volledige hoogte zichtbaar is. De breedte van de pagina kan groter of kleiner zijn dan de breedte van het venster. De pagina wordt op de horizontale positie geplaatst die de parameter Left opgeeft

5 = "FitR" - de pagina wordt ingezoomd zodat een bepaalde rechthoek op de pagina zichtbaar is. De parameters Left, Top, Right en Bottom bepalen het rechthoekige gebied op de pagina

6 = "FitB" - de pagina wordt ingezoomd zodat de bounding box zichtbaar is

7 = "FitBH" - de pagina wordt verticaal gepositioneerd op de positie die de parameter Top opgeeft. De pagina wordt ingezoomd zodat de volledige breedte van de bounding box zichtbaar is

8 = "FitBV" - de pagina wordt op de horizontale positie geplaatst die de parameter Left opgeeft. De pagina wordt precies ver genoeng ingezoomd om de volledige hoogte van de bounding box in het venster te passen

DestLeft

De horizontale positie die wordt gebruikt door DestType = 1, 4, 5 en 8

DestTop

De verticale positie die wordt gebruikt door DestType = 1, 3, 5 en 7

DestRight

De horizontale positie van de rechterrand van de rechthoek. Wordt gebruikt door DestType = 5

DestBottom

De horizontale positie van de onderkant van de rechthoek. Wordt gebruikt door 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,