SetOutlineRemoteDestination

Bogmærker

Beskrivelse

Indstiller dispositionselementet (bogmærket) til at åbne en anden PDF, når der klikkes på det.

Åbningssidenummeret og forskellige værdier for størrelse og placering kan angives

Bemærk: Da sidestørrelsen i måldokumentet ikke kendes, angives alle positioner i punkter målt fra nederste venstre hjørne på åbningssiden

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

Parametre

OutlineID

Dispositionens ID som returneret af funktionen NewOutline. Alternativt kan funktionen GetOutlineID bruges til at hente et gyldigt dispositions-ID

FileName

Filnavnet på det PDF-dokument, der skal åbnes, når der klikkes på dispositionen. Det skal have et bestemt format. Omvendte skråstreger skal konverteres til skråstreger, og et eventuelt drev skal kun angives som drevbogstavet mellem skråstreger uden kolon. Filen "c:\my documents\hello.pdf" skal f.eks. angives som "/c/my documents/hello.pdf". Relative stinavne er gyldige, herunder stier med operatoren ".." til at gå én mappe op

OpenPage

Det sidenummer, der skal springes til, når måldokumentet åbnes. Den første side har indeks nul (0).

Zoom

Den zoomprocent, der skal bruges, når dokumentet åbnes; gyldige værdier er fra 0 til 6400. Bruges kun til DestType = 1 og bør indstilles til 0 for andre DestTypes

DestType

1 = "XYZ" - målsiden placeres ved det punkt, der er angivet af parametrene Left og Top. Parameteren Zoom angiver zoomprocenten.

2 = "Fit" - hele siden zoomes, så den passer i vinduet. Ingen af de andre parametre bruges, og de skal angives til nul.

3 = "FitH" - siden zoomes, så hele sidens bredde er synlig. Sidens højde kan være større eller mindre end vinduets højde. Siden placeres på den lodrette position, der er angivet af parameteren Top

4 = "FitV" - siden zoomes, så hele sidens højde er synlig. Sidens bredde kan være større eller mindre end vinduets bredde. Siden placeres ved den vandrette position, som parameteren Left angiver

5 = "FitR" - siden zoomes, så et bestemt rektangel på siden er synligt. Parametrene Left, Top, Right og Bottom definerer det rektangulære område på siden.

6 = "FitB" - siden zoomes, så its' afgrænsningsramme er synlig.

7 = "FitBH" - siden placeres lodret på den position, som parameteren Top angiver. Siden zoomes, så hele bredden af PDF'ens afgrænsningsboks er synlig.

8 = "FitBV" - siden placeres ved den vandrette position, som parameteren Left angiver. Siden zoomes netop så meget, at hele afgrænsningsfeltets højde passer i vinduet.

PntLeft

Den vandrette position, der bruges af DestType = 1, 4, 5 og 8. Positionen angives i punkter målt fra nederste venstre hjørne på destinationsdokument'ets side

PntTop

Den lodrette position, der bruges af DestType = 1, 3, 5 og 7. Positionen angives i punkter målt fra det nederste venstre hjørne på måldokument'ets side.

PntRight

Den vandrette position for rektanglets højre kant. Bruges af DestType = 5. Positionen angives i punkter målt fra PDF'ens nederste venstre sidehjørne i måldokumentet.

PntBottom

Den vandrette placering af rektanglets bund. Bruges af DestType = 5. Placeringen angives i punkter målt fra nederste venstre hjørne af måldokumentet's side.

NewWindow

0 = Erstat det aktuelle dokument med måldokumentet

1 = Åbn måldokumentet i et nyt vindue, medmindre brugeren har angivet en anden præference i PDF-fremviseren

Returværdier