SetOutlineRemoteDestination

Metmenys

Aprašymas

Nustato struktūros elementą (žymę) kitam PDF atverti, kai spustelėjama

Galima nurodyti atvėrimo puslapio numerį ir įvairias dydžio / padėties reikšmes

Pastaba: nes tikslinio dokumento puslapio dydis nežinomas, visos padėtys nurodomos taškais, matuojamais nuo atveriamojo puslapio apatinio kairiojo kampo

Sintaksė

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

Parametrai

OutlineID

Struktūros ID, kurį grąžina NewOutline funkcija. Galiojantį struktūros ID taip pat galima gauti GetOutlineID funkcija

FileName

Atveriamino PDF dokumento failo pavadinimas, spustelėjus struktūrą. Jis turi būti tam tikru formatu. Atgalinius pasvirusius brūkšnius reikia pakeisti į priekinius, o diską, jei toks yra, nurodyti kaip tik disko raidę tarp priekinių pasvirusių brūkšnių be dvitaškio. Pavyzdžiui, failą "c:\my documents\hello.pdf" reikia nurodyti kaip "/c/my documents/hello.pdf". Santykiniai kelių vardai galioja, įskaitant kelius su ".." operatoriumi, kuriuo peršokama katalogu aukštyn

OpenPage

Puslapio numeris, į kurį peršokama atvėrus tikslinįjį dokumentą. Pirmasis puslapis turi nulinį (0) indeksą

Zoom

Mastelio procentai, naudojami atvėrus dokumentą; galiojančios reikšmės nuo 0 iki 6400. Naudojami tik kai DestType = 1, kitoms DestType reikšmėms turėtų būti 0

DestType

1 = "XYZ" – tikslinis puslapis nustatomas į Left ir Top parametrų nurodytą tašką. Zoom parametras nurodo mastelio keitimo procentą

2 = "Fit" – visas puslapis masteliu pritaikomas prie lango. Kiti parametrai nenaudojami ir turi būti nustatyti į nulį

3 = "FitH" – puslapio mastelis keičiamas taip, kad būtų matomas visas jo plotis. Puslapio aukštis gali būti didesnis arba mažesnis už lango aukštį. Puslapis nustatomas į Top parametro nurodytą vertikalią padėtį

4 = "FitV" – puslapio mastelis keičiamas taip, kad būtų matomas visas jo aukštis. Puslapio plotis gali būti didesnis arba mažesnis už lango plotį. Puslapis nustatomas į Left parametro nurodytą horizontalią padėtį

5 = "FitR" – puslapio mastelis keičiamas taip, kad būtų matomas tam tikras puslapio stačiakampis. Parametrai Left, Top, Right ir Bottom apibrėžia stačiakampę puslapio sritį

6 = "FitB" – puslapio mastelis keičiamas taip, kad būtų matomas jo apjuosiantis stačiakampis (it's bounding box)

7 = "FitBH" – puslapis nustatomas į Top parametro nurodytą vertikalią padėtį. Puslapio mastelis keičiamas taip, kad būtų matomas visas jo apjuosiančio stačiakampio plotis (page's bounding box)

8 = "FitBV" – puslapis nustatomas į Left parametro nurodytą horizontalią padėtį. Puslapio mastelis keičiamas tik tiek, kad visas apjuosiančio stačiakampio aukštis tilptų lange

PntLeft

Horizontali padėtis, naudojama kai DestType = 1, 4, 5 ir 8. Padėtis nurodoma taškais, matuojamais nuo tiksliniojo dokumento puslapio apatinio kairiojo kampo

PntTop

Vertikali padėtis, naudojama kai DestType = 1, 3, 5 ir 7. Padėtis nurodoma taškais, matuojamais nuo tiksliniojo dokumento puslapio apatinio kairiojo kampo

PntRight

Stačiakampio dešiniojo krašto horizontali padėtis. Naudojama kai DestType = 5. Padėtis nurodoma taškais, matuojamais nuo tiksliniojo dokumento puslapio apatinio kairiojo kampo

PntBottom

Stačiakampio apačios horizontali padėtis. Naudojama kai DestType = 5. Padėtis nurodoma taškais, matuojamais nuo tiksliniojo dokumento puslapio apatinio kairiojo kampo

NewWindow

0 = pakeisti esamąjį dokumentą tiksliniu dokumentu

1 = atverti tikslinįjį dokumentą naujajame lange, nebent naudotojas PDF peržiūros programoje nurodė kitokį nustatymą

Grąžinamos reikšmės