SetOutlineRemoteDestination
Könyvjelzők
Leírás
A körvonalelem (könyvjelző) kattintásakor egy másik PDF megnyitására állítja be
Megadható a kezdő oldalszám, valamint a különböző méretezési és pozicionálási értékek
Megjegyzés: mivel a céldokumentum oldalmérete nem ismert, minden pozíciót pontokban kell megadni, a nyitóoldal bal alsó sarkától mérve
Szintaxis
Delphi
Function TPDFlib.SetOutlineRemoteDestination(OutlineID: Integer; Const FileName: WideString; OpenPage, Zoom, DestType: Integer; PntLeft, PntTop, PntRight, PntBottom: Double; NewWindow: Integer): Integer;
ActiveX
Function PDFlib::SetOutlineRemoteDestination(OutlineID As Long, FileName As String, OpenPage As Long, Zoom As Long, DestType As Long, PntLeft As Double, PntTop As Double, PntRight As Double, PntBottom As Double, NewWindow As Long) As Long
DLL
int DLSetOutlineRemoteDestination(int InstanceID, int OutlineID, const wchar_t * FileName, int OpenPage, int Zoom, int DestType, double PntLeft, double PntTop, double PntRight, double PntBottom, int NewWindow);
Paraméterek
OutlineID
A NewOutline függvény által visszaadott körvonalazonosító. Másik lehetőségként a GetOutlineID függvénnyel is lekérhet érvényes körvonalazonosítót
FileName
A PDF-dokumentum megnyitásakor a körvonalra kattintva használandó fájlnév. Ennek meghatározott formátumúnak kell lennie. A fordított perjeleket előre perjelekre kell cserélni, és a meghajtót, ha van, csak a meghajtó betűjeként, kettőspont nélkül, előre perjelek között kell megadni. Például a "c:\my documents\hello.pdf" fájlt "/c/my documents/hello.pdf" alakban kell megadni. A relatív elérési utak is érvényesek, ideértve a könyvtárban feljebb lépő ".." operátort tartalmazó utakat is
OpenPage
A cél dokumentum megnyitásakor átugrandó oldalszám. Az első oldal indexe nulla (0)
Zoom
A dokumentum megnyitásakor használandó nagyítási százalék, érvényes értéke 0–6400. Csak DestType = 1 esetén használatos, egyéb DestTypes esetén 0-ra kell állítani
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
PntLeft
A DestType = 1, 4, 5 és 8 által használt vízszintes pozíció. A pozíció pontokban van megadva, a céldokumentum („target document's page”) bal alsó sarkától mérve
PntTop
A DestType = 1, 3, 5 és 7 által használt függőleges helyzet. A helyzetet a céldokumentum's oldalának bal alsó sarkától mért pontokban adja meg
PntRight
A téglalap jobb szélének vízszintes pozíciója. A DestType = 5 esetén használatos. A pozíció a céldokumentum's oldalának bal alsó sarkától mért pontokban van megadva
PntBottom
A téglalap alsó szélének vízszintes helyzete. A DestType = 5 esetén használatos. A helyzetet a céldokumentum's oldalának bal alsó sarkától mért pontokban kell megadni
NewWindow
0 = Az aktuális dokumentum lecserélése a céldokumentummal
1 = A céldokumentum megnyitása új ablakban, hacsak a felhasználó nem adott meg más beállítást a PDF-megjelenítőben
Visszatérési értékek
| 0 | Az OutlineID érvénytelen volt |
|---|---|
| 1 | A körvonal célhelye sikeresen be lett állítva double PntBottom, int NewWindow); |