AddRelativeLinkToFileExA

Annotations and hotspot links

Beskrivelse

Den avsluttende A angir ANSI-inngangspunktet (char) i DLL-en; ActiveX/COM-flaten eksponerer kun Unicode-formen. Oppførselen er identisk med AddRelativeLinkToFileEx og strengargumenter tolkes ut fra gjeldende kodetabell i SetAnsiMode

Legger til et klikkbart hotspot-rektangel på den valgte siden som via relativ sti lenker til en bestemt side og posisjon i et annet PDF-dokument. Bruk SetAnnotBorderColor-funksjonen for å endre fargen på hotspot-kanten

Lenken til måldokumentet går bare via filnavnet. Det betyr at måldokumentets sidedimensjoner ikke er kjent, så DestLeft-, DestTop-, DestRight- og DestBottom-parameterne oppgis alltid i punkter målt fra målsidens MediaBox nedre venstre hjørne

Syntaks

Delphi

Function DLAddRelativeLinkToFileExA(InstanceID: Integer; Left, Top, Width, Height: Double; FileName: PAnsiChar; DestPage, NewWindow, Options, Zoom, DestType: Integer; DestLeft, DestTop, DestRight, DestBottom: Double): Integer;

DLL

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

Parametere

Left

Den horisontale koordinaten til hotspot-rektangelets venstre kant

Top

Den vertikale koordinaten til hotspot-rektangelets øvre kant

Width

Bredden til hotspot-rektangelet

Height

Høyden til hotspot-rektangelet

FileName

Full absolutt sti og filnavn for PDF-dokumentet det skal lenkes til; det konverteres til relativ sti

DestPage

Siden i måldokumentet det skal lenkes til

NewWindow

0 = Lukk gjeldende dokument og åpne det nye dokumentet

1 = Åpne gjeldende dokument i et nytt vindu

Options

Angir hvordan lenken skal se ut:

0 = No border

1 = Draw a border

Zoom-prosenten som skal brukes for destinasjonsobjektet, gyldige verdier fra 0 til 6400. Brukes bare for DestType = 1 og skal settes til 0 for andre DestTypes

Zoom

DestType

1 = "XYZ" - målsiden plasseres slik at punktet angitt av Left- og Top-parameterne vises. Zoom-parameteren angir zoom-prosenten

2 = "Fit" - hele siden zoomes så den passer i vinduet. Ingen av de andre parameterne brukes, og de skal settes til null

3 = "FitH" - siden zoomes slik at hele sidebredden er synlig. Sidehøyden kan være større eller mindre enn vinduets høyde. Siden plasseres på den vertikale posisjonen angitt av Top-parameteren

4 = "FitV" - siden zoomes slik at hele sidehøyden er synlig. Sidebredden kan være større eller mindre enn vinduets bredde. Siden plasseres på den horisontale posisjonen angitt av Left-parameteren

5 = "FitR" - siden zoomes slik at et bestemt rektangel på siden blir synlig. Left-, Top-, Right- og Bottom-parameterne definerer det rektangulære området på siden

6 = "FitB" - siden zoomes slik at dens avgrensende boks blir synlig

7 = "FitBH" - siden plasseres vertikalt på posisjonen angitt av Top-parameteren. Siden zoomes slik at hele bredden av sidens avgrensende boks er synlig

8 = "FitBV" - siden plasseres på den horisontale posisjonen angitt av Left-parameteren. Siden zoomes akkurat nok til at hele høyden av den avgrensende boksen passer i vinduet

DestLeft

Den horisontale posisjonen, brukes av DestType = 1, 4, 5 og 8

DestTop

Den vertikale posisjonen, brukes av DestType = 1, 3, 5 og 7

DestRight

Den horisontale posisjonen til rektangelets høyre kant. Brukes av DestType = 5

DestBottom

Den horisontale posisjonen til rektangelets nedre kant. Brukes av 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,