NewDestination

Annotationer og hotspotlinks, dokumenthåndtering

Beskrivelse

Opretter et nyt destinationsobjekt, der kan bruges sammen med funktionerne AddLinkToDestination, GetDestPage, GetDestType eller GetDestValue

Syntaks

Delphi

Function TPDFlib.NewDestination(DestPage, Zoom, DestType: Integer; Left, Top, Right, Bottom: Double): Integer;

ActiveX

Function PDFlib::NewDestination(DestPage As Long, Zoom As Long, DestType As Long, Left As Double, Top As Double, Right As Double, Bottom As Double) As Long

DLL

int DLNewDestination(int InstanceID, int DestPage, int Zoom, int DestType, double Left, double Top, double Right, double Bottom);

Parametre

DestPage	Sidenummeret, som dette destinationsobjekt linker til
Zoom	Den zoomprocent, der skal bruges til destinationsobjektet, med gyldige værdier fra 0 til 6400. Bruges kun ved DestType = 1 og skal angives som 0 for andre DestTypes
DestType	1 = "XYZ" - målsiden placeres ved det punkt, som parametrene Left og Top angiver. Parameteren Zoom angiver zoomprocenten. 2 = "Fit" - hele siden zoomes, så den passer i vinduet. Ingen af de øvrige parametre bruges og skal sættes til nul. 3 = "FitH" - siden zoomes, så hele sidebredden er synlig. Sidens højde kan være større eller mindre end vinduets højde. Siden placeres ved den lodrette position, som parameteren Top angiver. 4 = "FitV" - siden zoomes, så hele sidehøjden kan ses. 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å PDF'ens afgrænsningsfelt er synligt. 7 = "FitBH" - siden placeres lodret ved den position, som parameteren Top angiver. Siden zoomes, så hele bredden af PDF'ens afgrænsningsfelt 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.
Left	Den vandrette placering, der bruges af DestType = 1, 4, 5 og 8
Top	Den lodrette position, der bruges af DestType = 1, 3, 5 og 7 Den vandrette position for rektanglets højre kant. Bruges af DestType = 5
Right
Bottom	Den vandrette position for rektanglets bund. Bruges af DestType = 5

Returværdier

0	Parameteren DestPage var ugyldig En DestID-værdi
Non-zero