DASetPageBox

Suora pääsy -toiminnot, sivun ominaisuudet

Kuvaus

Asettaa annetun sivun rajaus­suorakulmioiden mitat. MediaBox esittää sivun fyysisen väliaineen

CropBox kuvaa sivun näkyvää aluetta, ja sisältö rajataan tähän alueeseen. BleedBox muistuttaa CropBoxia, mutta se on tuotantoympäristössä käytettävä suorakulmio

TrimBox kertoo valmiin sivun mitat leikkauksen jälkeen, ja ArtBox määrittää sivun varsinaisen sisällön laajuuden sivun tekijän tarkoittamalla tavalla

PDF-versiokäytäntö: sivusanakirjan tietueet BleedBox, TrimBox ja ArtBox vaativat PDF 1.3:n. Kun Direct Access muokkaa vanhemman version lähdettä eikä tallennusversiota ole lukittu, DASetPageBox korottaa tallennetun asiakirjan otsikon PDF 1.3:een, jotta se vastaa uusia rajaus­laatikkotietueita

Syntaksi

Delphi

Function TPDFlib.DASetPageBox(FileHandle, PageRef, BoxIndex: Integer; X1, Y1, X2, Y2: Double): Integer;

ActiveX

Function PDFlib::DASetPageBox(FileHandle As Long, PageRef As Long, BoxIndex As Long, X1 As Double, Y1 As Double, X2 As Double, Y2 As Double) As Long

DLL

int DLDASetPageBox(int InstanceID, int FileHandle, int PageRef, int BoxIndex, double X1, double Y1, double X2, double Y2);

Parametrit

FileHandleKahva, jonka palauttavat DAOpenFile-, DAOpenFileReadOnly- tai DAOpenFromStream-funktiot
PageRefSivuviittaus, jonka palauttavat DAFindPage- tai DANewPage-funktiot
BoxIndex1 = MediaBox 2 = CropBox 3 = BleedBox 4 = TrimBox 5 = ArtBox
X1Laatikon vasemman alakulman vaakakoordinaatti, pisteinä sivun vasemmasta reunasta mitattuna
Y1Laatikon vasemman alakulman pystysuuntainen koordinaatti mitattuna pisteinä sivun alareunasta
X2Laatikon oikean yläkulman vaakakoordinaatti, pisteinä sivun alareunasta mitattuna
Y2Laatikon oikean yläkulman pystykoordinaatti, pisteinä sivun alareunasta mitattuna

Paluuarvot

0FileHandle- tai PageRef-parametrit olivat virheelliset
1Success