NewDestination

Merkinnät ja hotspot-linkit, asiakirjojen hallinta

Kuvaus

Luo uuden kohdeobjektin, jota voi käyttää funktioiden AddLinkToDestination, GetDestPage, GetDestType tai GetDestValue kanssa

Syntaksi

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

Parametrit

DestPageSivunumero, johon tämä kohdeobjekti linkittää
ZoomKohdeobjektissa käytettävä zoomausprosentti, jonka kelvolliset arvot ovat 0–6400. Käytetään vain, kun DestType = 1; muiden DestType-arvojen kohdalla arvoksi tulee asettaa 0
DestType1 = "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 rajaus­laatikko näkyy 7 = "FitBH" - sivu asettuu pystysuunnassa Top-parametrin määrittämään kohtaan. Sivu zoomataan niin, että koko sivun rajaus­laatikon leveys näkyy 8 = "FitBV" - sivu asettuu Left-parametrin määrittämään vaakasijaintiin. Sivu zoomataan vain niin paljon, että rajaus­laatikon koko korkeus mahtuu ikkunaan
LeftVaakasijainti, jota käytetään arvoilla DestType = 1, 4, 5 ja 8
TopPystysijainti, jota käytetään arvoilla DestType = 1, 3, 5 ja 7 Suorakulmion oikean reunan vaakasijainti. Käytetään, kun DestType = 5
Right
BottomSuorakulmion alareunan vaakasijainti. Käytetään, kun DestType = 5

Paluuarvot

0DestPage-parametri oli virheellinen DestID-arvo
Non-zero