SetOutlineRemoteDestination

Bokmerker

Beskrivelse

Setjer disposisjonselementet (bokmerket) til å åpne en annen PDF når det klikkes

Åpningssidens nummer og ulike størrelses-/posisjonsverdier kan angis

Merk: fordi måldokumentets sidestørrelse ikke er kjent, oppgis alle posisjoner i punkter målt fra åpningssidens nedre venstre hjørne

Syntaks

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

Parametere

OutlineID

ID-en til disposisjonen, slik den returneres av NewOutline-funksjonen. Alternativt kan GetOutlineID-funksjonen brukes for å hente en gyldig disposisjons-ID

FileName

Filnavnet på PDF-dokumentet som skal åpnes når disposisjonen klikkes. Det skal være i et bestemt format. Backslashes skal konverteres til skråstreker, og stasjonsbokstaven, hvis noen, skal angis som bare bokstaven mellom skråstreker uten kolon. For eksempel skal filen "c:\my documents\hello.pdf" angis som "/c/my documents/hello.pdf". Relative stinavn er gyldige, inkludert stier som inneholder ".."-operatoren for å gå opp en mappe

OpenPage

Sidenummeret som skal hoppes til når måldokumentet åpnes. Den første siden har indeks null (0)

Zoom

Zoom-prosenten som skal brukes når dokumentet åpnes, gyldige verdier fra 0 til 6400. Brukes bare for DestType = 1 og skal settes til 0 for andre DestTypes

DestType

1 = "XYZ" - målsiden plasseres slik at punktet angitt av Left- og Top-parameterne vises. Zoom-parameteren angir zoom-prosenten

2 = "Fit" - hele siden zoomes så den passer i vinduet. Ingen av de andre parameterne brukes, og de skal settes til null

3 = "FitH" - siden zoomes slik at hele sidebredden er synlig. Sidehøyden kan være større eller mindre enn vinduets høyde. Siden plasseres på den vertikale posisjonen angitt av Top-parameteren

4 = "FitV" - siden zoomes slik at hele sidehøyden er synlig. Sidebredden kan være større eller mindre enn vinduets bredde. Siden plasseres på den horisontale posisjonen angitt av Left-parameteren

5 = "FitR" - siden zoomes slik at et bestemt rektangel på siden blir synlig. Left-, Top-, Right- og Bottom-parameterne definerer det rektangulære området på siden

6 = "FitB" - siden zoomes slik at dens avgrensende boks blir synlig

7 = "FitBH" - siden plasseres vertikalt på posisjonen angitt av Top-parameteren. Siden zoomes slik at hele bredden av sidens avgrensende boks er synlig

8 = "FitBV" - siden plasseres på den horisontale posisjonen angitt av Left-parameteren. Siden zoomes akkurat nok til at hele høyden av den avgrensende boksen passer i vinduet

PntLeft

Den horisontale posisjonen, brukes av DestType = 1, 4, 5 og 8. Posisjonen angis i punkter målt fra måldokumentets sides nedre venstre hjørne

PntTop

Den vertikale posisjonen, brukes av DestType = 1, 3, 5 og 7. Posisjonen angis i punkter målt fra måldokumentets sides nedre venstre hjørne

PntRight

Den horisontale posisjonen til rektangelets høyre kant. Brukes av DestType = 5. Posisjonen angis i punkter målt fra måldokumentets sides nedre venstre hjørne

PntBottom

Den horisontale posisjonen til rektangelets nedre kant. Brukes av DestType = 5. Posisjonen angis i punkter målt fra måldokumentets sides nedre venstre hjørne

NewWindow

0 = Erstatt gjeldende dokument med måldokumentet

1 = Be fremviseren om å åpne måldokumentet i et nytt vindu, med mindre brukeren har valgt en annen innstilling i PDF-fremviseren

Returverdier