DASetPageBox
Functionaliteit voor directe toegang, pagina-eigenschappen
Beschrijving
Stelt de afmetingen van de grensrechthoeken van de opgegeven pagina in. De MediaBox representeert het fysieke medium van de pagina
De CropBox vertegenwoordigt het zichtbare gebied van de pagina; de inhoud wordt tot dit gebied afgeknipt. De BleedBox lijkt op de CropBox, maar is de rechthoek die in een productieomgeving wordt gebruikt
De TrimBox geeft de beoogde afmetingen van de kant-en-klare pagina na bijsnijden aan, en de ArtBox bepaalt de omvang van de zinvolle inhoud van de pagina zoals de maker die voor ogen had
PDF-versiegedrag: BleedBox-, TrimBox- en ArtBox-entries in het paginawoordenboek vereisen PDF 1.3. Wanneer Direct Access een lagere versie van de bron wijzigt en de opslagversie niet is vergrendeld, verhoogt DASetPageBox de header van het opgeslagen document naar PDF 1.3 zodat die bij de nieuwe grensbox-entries past
Syntaxis
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);
Parameters
| FileHandle | Een handle geretourneerd door de functies DAOpenFile, DAOpenFileReadOnly of DAOpenFromStream |
|---|---|
| PageRef | Een paginareferentie die door de functies DAFindPage of DANewPage wordt geretourneerd |
| BoxIndex | 1 = MediaBox 2 = CropBox 3 = BleedBox 4 = TrimBox 5 = ArtBox |
| X1 | De horizontale coördinaat van de linkerbenedenhoek van de box, gemeten in punten vanaf de linkerrand van de pagina |
| Y1 | De verticale coördinaat van de linkerbenedenhoek van de doos, gemeten in punten vanaf de onderkant van de pagina |
| X2 | De horizontale coördinaat van de rechterbovenhoek van de box, gemeten in punten vanaf de onderrand van de pagina |
| Y2 | De verticale coördinaat van de rechterbovenhoek van de box, gemeten in punten vanaf de onderrand van de pagina |
Retourwaarden
| 0 | De parameters FileHandle of PageRef waren ongeldig |
|---|---|
| 1 | Success |