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

0Az OutlineID érvénytelen volt
1A körvonal célhelye sikeresen be lett állítva double PntBottom, int NewWindow);