AddRelativeLinkToFileExA

Jegyzetek és aktívterület-hivatkozások

Leírás

A záró A az ANSI (char) DLL belépési pontját jelöli; az ActiveX/COM felület csak az Unicode változatot teszi elérhetővé. Működése azonos a(z) AddRelativeLinkToFileEx működésével, a karakterlánc-argumentumokat pedig az aktuális SetAnsiMode kódlap szerint értelmezi

Kattintható hotspot téglalapot ad a kiválasztott oldalhoz, amely relatív útvonalon egy másik PDF-dokumentum megadott oldalára és pozíciójára hivatkozik. A hotspot keretének színét a SetAnnotBorderColor függvénnyel módosíthatja

A céldokumentumra mutató hivatkozás csak a fájlnéven keresztül történik. Ez azt jelenti, hogy a céldokumentum oldalméretei nem ismertek, ezért a DestLeft, DestTop, DestRight és DestBottom paramétereket mindig a céloldal's MediaBox bal alsó sarkától mért pontokban kell megadni

Szintaxis

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

Paraméterek

Left

A hotspot téglalap bal szélének vízszintes koordinátája

Top

A forróponttéglalap felső szélének függőleges koordinátája

Width

A hotspot-téglalap szélessége

Height

A hotspot téglalap magassága

FileName

A hivatkozandó PDF-dokumentum teljes abszolút elérési útja és fájlneve; relatív útvonallá lesz alakítva

DestPage

A hivatkozandó oldal a céldokumentumban

NewWindow

0 = Az aktuális dokumentum bezárása, majd az új dokumentum megnyitása

1 = Az aktuális dokumentum megnyitása új ablakban

Options

Meghatározza a hivatkozás megjelenését:

0 = Nincs keret

1 = Keret rajzolása

A célobjektumhoz használt nagyítási százalék, amelynek érvényes értéke 0 és 6400 között van. Csak DestType = 1 esetén használatos, más DestType értékeknél 0-ra kell állítani

Zoom

DestType

1 = "XYZ" - a céloldal a Left és Top paraméterek által megadott pontra kerül. A Zoom paraméter adja meg a nagyítás százalékát

2 = "Fit" – a teljes oldal az ablakhoz igazodó nagyítással jelenik meg. A többi paraméter nem használatos, ezért nullára kell állítani

3 = "FitH" – az oldal úgy nagyítódik, hogy teljes szélessége látható legyen. Az oldal magassága nagyobb vagy kisebb lehet az ablak magasságánál. Az oldal a Top paraméter által megadott függőleges helyzetben jelenik meg

4 = "FitV" – az oldalt úgy nagyítja, hogy a teljes oldalmagasság látható legyen. Az oldal szélessége kisebb vagy nagyobb lehet az ablak szélességénél. Az oldal a Left paraméter által megadott vízszintes pozícióba kerül

5 = "FitR" – az oldal úgy nagyítódik, hogy az oldalon egy meghatározott téglalap látható legyen. A Left, Top, Right és Bottom paraméterek az oldalon lévő téglalap alakú területet határozzák meg

6 = "FitB" - az oldal úgy van nagyítva, hogy a befoglaló kerete' látható legyen

7 = "FitBH" – az oldal függőlegesen a Top paraméter által megadott helyre kerül. Az oldal úgy nagyítódik, hogy a PDF-oldal's befoglaló keretének teljes szélessége látható legyen

8 = "FitBV" - az oldal a Left paraméter által megadott vízszintes pozícióra kerül. Az oldal annyira nagyít, hogy a befoglaló keret teljes magassága éppen elférjen az ablakban

DestLeft

A DestType = 1, 4, 5 és 8 által használt vízszintes pozíció

DestTop

A DestType = 1, 3, 5 és 7 által használt függőleges pozíció

DestRight

A téglalap jobb oldali élének vízszintes pozíciója. DestType = 5 esetén használatos

DestBottom

A téglalap alsó részének vízszintes helyzete A DestType = 5 esetén használatos

Paraméterlista: 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,