DASetPageBox

Fonctionnalité Direct Access, propriétés des pages

Description

Définit les dimensions des rectangles de limites d'une page indiquée. La MediaBox représente le support physique de la page

CropBox représente la région visible et le contenu y est détouré. BleedBox est semblable, mais désigne le rectangle utilisé en environnement de production

TrimBox indique les dimensions voulues de la page finie après rognage, et ArtBox définit l'étendue du contenu significatif d'une page selon l'intention de son créateur

Comportement de version PDF : les entrées BleedBox, TrimBox et ArtBox exigent PDF 1.3. Lorsque Direct Access modifie une source de version inférieure sans verrouillage d’enregistrement, DASetPageBox relève l’en-tête à PDF 1.3 afin de correspondre aux nouvelles zones

Syntaxe

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

Paramètres

FileHandle	Un handle renvoyé par les fonctions DAOpenFile, DAOpenFileReadOnly ou DAOpenFromStream
PageRef	Référence de page renvoyée par les fonctions DAFindPage ou DANewPage
BoxIndex	1 = MediaBox 2 = CropBox 3 = BleedBox 4 = TrimBox 5 = ArtBox
X1	La coordonnée horizontale de l'angle inférieur gauche du cadre, mesurée en points depuis le bord gauche de la page
Y1	La coordonnée verticale de l'angle inférieur gauche du cadre, mesurée en points depuis le bas de la page
X2	La coordonnée horizontale de l'angle supérieur droit du cadre, mesurée en points depuis le bas de la page
Y2	La coordonnée verticale de l'angle supérieur droit du cadre, mesurée en points depuis le bas de la page

Valeurs de retour

0	Les paramètres FileHandle ou PageRef n’étaient pas valides
1	Success