DASetPageBox

פונקציונליות גישה ישירה, מאפייני עמוד

תיאור

מגדירה את ממדי מלבני התחום של העמוד שצוין. ה-MediaBox מייצג את המדיום הפיזי של העמוד

ה-CropBox מייצג את האזור הנראה של הדף, והתוכן ייחתך לאזור הזה. ה-BleedBox דומה ל-CropBox, אך זהו המלבן המשמש בסביבת הפקה

TrimBox מציין את המידות המיועדות של הדף המוגמר לאחר החיתוך, ו-ArtBox מגדיר את היקף התוכן המשמעותי של הדף (page's meaningful content) כפי שהתכוון יוצר הדף (page's creator)

התנהגות גרסת PDF: כניסות מילון הדף BleedBox, TrimBox ו-ArtBox דורשות PDF 1.3. כאשר Direct Access משנה מקור בגרסה נמוכה יותר וגרסת השמירה אינה נעולה, DASetPageBox מעלה את כותרת המסמך הנשמר ל-PDF 1.3 כדי שתתאים לכניסות תיבת התיחום החדשות.

תחביר

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

פרמטרים

FileHandlehandle שהוחזר על ידי הפונקציות DAOpenFile, DAOpenFileReadOnly או DAOpenFromStream
PageRefהפניה לדף שהוחזרה על ידי הפונקציות DAFindPage או DANewPage
BoxIndex1 = MediaBox 2 = CropBox 3 = BleedBox 4 = TrimBox 5 = ArtBox
X1הקואורדינטה האופקית של הפינה השמאלית-תחתונה של התיבה, נמדדת בנקודות מהקצה השמאלי של העמוד
Y1הקואורדינטה האנכית של הפינה השמאלית התחתונה של התיבה, נמדדת בנקודות מתחתית הדף
X2הקואורדינטה האופקית של הפינה הימנית-עליונה של התיבה, נמדדת בנקודות מתחתית העמוד
Y2הקואורדינטה האנכית של הפינה הימנית-עליונה של התיבה, נמדדת בנקודות מתחתית העמוד

ערכי החזרה

0הפרמטרים FileHandle או PageRef לא היו תקינים
1Success