DASetPageBox

funkcionalnost neposrednega dostopa, lastnosti strani

Opis

Nastavi mere omejitvenih pravokotnikov navedene strani. MediaBox predstavlja fizični medij strani

CropBox predstavlja vidno območje strani, vsebina bo obrezana na to območje. BleedBox je podoben CropBox, vendar je pravokotnik, uporabljen v produkcijskem okolju

TrimBox določa predvidene mere končne strani po obrezovanju, ArtBox pa obseg smiselnih vsebin strani, tako kot jih je zasnoval njen ustvarjalec

Obnašanje glede različice PDF: vnosi BleedBox, TrimBox in ArtBox v slovarju strani zahtevajo PDF 1.3. Ko Direct Access spremeni nižjerazlični vir in različica shranjevanja ni zaklenjena, DASetPageBox dvigne glavo shranjenega dokumenta na PDF 1.3, tako da ustreza novim vnosom mejnega okvirja

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	Handle, ki ga vrnejo funkcije DAOpenFile, DAOpenFileReadOnly ali DAOpenFromStream
PageRef	Sklic na stran, ki ga vrnejo funkcije DAFindPage ali DANewPage
BoxIndex	1 = MediaBox 2 = CropBox 3 = BleedBox 4 = TrimBox 5 = ArtBox
X1	Vodoravna koordinata spodnjega levega kota okvirja, merjena v točkah od levega roba strani
Y1	Navpična koordinata spodnjega levega vogala polja, merjena v točkah od dna strani
X2	Vodoravna koordinata zgornjega desnega kota okvirja, merjena v točkah od spodnjega roba strani
Y2	Navpična koordinata zgornjega desnega vogala okvirja, merjena v točkah od spodnjega roba strani

Vrnjene vrednosti

0	Parametra FileHandle ali PageRef nista bila veljavna
1	uspeh