SetOutlineRemoteDestination

Jäsennys

Kuvaus

Asettaa outline-kohdan (kirjanmerkin) avaamaan toisen PDF:n, kun sitä napsautetaan

Avaussivunumeron ja erilaisia kokoon ja sijaintiin liittyviä arvoja voi määrittää

Huom: koska kohdeasiakirjan sivukokoa ei tunneta, kaikki sijainnit annetaan pisteinä avaussivun vasemmasta alakulmasta mitattuina

Syntaksi

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

Parametrit

OutlineID

Outline-tunnuksen, jonka NewOutline-funktio palauttaa. Vaihtoehtoisesti kelvollisen outline-tunnuksen voi hakea GetOutlineID-funktiolla

FileName

Avattavan PDF-asiakirjan tiedostonimi, kun outlinea napsautetaan. Muodon on oltava tiettyä muotoa. Kenoviivat on muunnettava kauttaviivoiksi, ja asema, jos sellainen on, tulee ilmoittaa pelkkänä asema kirjaimena kauttaviivojen välissä ilman kaksoispistettä. Esimerkiksi tiedosto "c:\my documents\hello.pdf" ilmoitetaan muodossa "/c/my documents/hello.pdf". Suhteelliset polut kelpaavat, myös polut, joissa on ylöspäin siirtyvä ".."-operaattori

OpenPage

Sivunumero, jolle siirrytään, kun kohdeasiakirja avataan. Ensimmäinen sivu on indeksi nolla (0)

Zoom

Asiakirjaa avattaessa käytettävä zoomausprosentti, kelvolliset arvot 0–6400. Käytetään vain arvolla DestType = 1; muilla DestType-arvoilla asetettava nollaan

DestType

1 = "XYZ" - kohdesivu asettuu Left- ja Top-parametrien osoittamaan kohtaan. Zoom-parametri määrittää zoomausprosentin

2 = "Fit" - koko sivu zoomataan ikkunaan sopivaksi. Muita parametreja ei käytetä, ja ne tulee asettaa nollaan

3 = "FitH" - sivu zoomataan niin, että koko sivun leveys näkyy. Sivun korkeus voi olla ikkunan korkeutta suurempi tai pienempi. Sivu asettuu Top-parametrin määrittämään pystysijaintiin

4 = "FitV" - sivu zoomataan niin, että koko sivun korkeus näkyy. Sivun leveys voi olla ikkunan leveyttä suurempi tai pienempi. Sivu asettuu Left-parametrin määrittämään vaakasijaintiin

5 = "FitR" - sivu zoomataan niin, että sivun tietty suorakulmio näkyy. Left-, Top-, Right- ja Bottom-parametrit määrittävät suorakulmioalueen sivulla

6 = "FitB" - sivu zoomataan niin, että sen rajauslaatikko (bounding box) näkyy

7 = "FitBH" - sivu asettuu pystysuunnassa Top-parametrin määrittämään kohtaan. Sivu zoomataan niin, että koko sivun rajauslaatikon leveys näkyy

8 = "FitBV" - sivu asettuu Left-parametrin määrittämään vaakasijaintiin. Sivu zoomataan vain niin paljon, että rajauslaatikon koko korkeus mahtuu ikkunaan

PntLeft

Vaakasijainti, jota käytetään arvoilla DestType = 1, 4, 5 ja 8. Sijainti annetaan pisteinä kohdeasiakirjan sivun vasemmasta alakulmasta mitattuna

PntTop

Pystysijainti, jota käytetään arvoilla DestType = 1, 3, 5 ja 7. Sijainti annetaan pisteinä kohdeasiakirjan sivun vasemmasta alakulmasta mitattuna

PntRight

Suorakulmion oikean reunan vaakasijainti. Käytetään, kun DestType = 5. Sijainti annetaan pisteinä kohdeasiakirjan sivun vasemmasta alakulmasta mitattuna

PntBottom

Suorakulmion alareunan vaakasijainti. Käytetään, kun DestType = 5. Sijainti annetaan pisteinä kohdeasiakirjan sivun vasemmasta alakulmasta mitattuna

NewWindow

0 = korvaa nykyinen asiakirja kohdeasiakirjalla

1 = avaa kohdeasiakirja uuteen ikkunaan, ellei käyttäjä ole valinnut katselimessa toista asetusta

Paluuarvot