AddLinkToFileExA
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 AddLinkToFileEx og strengargumenter tolkes ut fra gjeldende kodetabell i SetAnsiMode
Legger til et klikkbart hotspot-rektangel på den valgte siden som 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 DLAddLinkToFileExA(InstanceID: Integer; Left, Top, Width, Height: Double; FileName: PAnsiChar; DestPage, NewWindow, Options, Zoom, DestType: Integer; DestLeft, DestTop, DestRight, DestBottom: Double): Integer;
DLL
int DLAddLinkToFileExA(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
Stien og filnavnet til PDF-dokumentet det skal lenkes til
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
double DestLeft, double DestTop, double DestRight, double DestBottom);
Height: Double; FileName: WideString; DestPage, NewWindow, Options, Zoom, DestType: Integer; DestLeft, DestTop, DestRight,