DASetPageBox
Funkcije izravnog pristupa, svojstva stranice
Opis
Postavlja dimenzije graničnih pravokutnika navedene stranice. MediaBox predstavlja fizički medij stranice
CropBox predstavlja vidljivo područje stranice; sadržaj će se izrezati na to područje. BleedBox je sličan CropBoxu, ali je to pravokutnik koji se upotrebljava u produkcijskom okruženju
TrimBox označava predviđene dimenzije dovršene stranice nakon odrezivanja, a ArtBox definira opseg smislenog sadržaja stranice kako ga je zamislio autor stranice
Ponašanje PDF verzije: unosi rječnika stranica BleedBox, TrimBox i ArtBox zahtijevaju PDF 1.3. Kada Direct Access mijenja izvor niže verzije, a verzija spremanja nije zaključana, DASetPageBox podiže zaglavlje spremljenog dokumenta na PDF 1.3 da odgovara novim unosima graničnog okvira
Sintaksa
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);
Parametri
| FileHandle | Ručka koju vraćaju funkcije DAOpenFile, DAOpenFileReadOnly ili DAOpenFromStream |
|---|---|
| PageRef | Referenca stranice koju vraćaju funkcije DAFindPage ili DANewPage |
| BoxIndex | 1 = MediaBox 2 = CropBox 3 = BleedBox 4 = TrimBox 5 = ArtBox |
| X1 | Vodoravna koordinata donjeg lijevog kuta okvira, mjerena u točkama od lijevog ruba stranice |
| Y1 | Okomita koordinata donjeg lijevog kuta okvira, izmjerena u točkama od dna stranice |
| X2 | Vodoravna koordinata gornjeg desnog kuta okvira, mjerena u točkama od dna stranice |
| Y2 | Okomita koordinata gornjeg desnog kuta okvira, mjerena u točkama od dna stranice |
Povratne vrijednosti
| 0 | Parametri FileHandle ili PageRef bili su nevaljani |
|---|---|
| 1 | Success |