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);
פרמטרים
| FileHandle | handle שהוחזר על ידי הפונקציות DAOpenFile, DAOpenFileReadOnly או DAOpenFromStream |
|---|---|
| PageRef | הפניה לדף שהוחזרה על ידי הפונקציות DAFindPage או DANewPage |
| BoxIndex | 1 = MediaBox 2 = CropBox 3 = BleedBox 4 = TrimBox 5 = ArtBox |
| X1 | הקואורדינטה האופקית של הפינה השמאלית-תחתונה של התיבה, נמדדת בנקודות מהקצה השמאלי של העמוד |
| Y1 | הקואורדינטה האנכית של הפינה השמאלית התחתונה של התיבה, נמדדת בנקודות מתחתית הדף |
| X2 | הקואורדינטה האופקית של הפינה הימנית-עליונה של התיבה, נמדדת בנקודות מתחתית העמוד |
| Y2 | הקואורדינטה האנכית של הפינה הימנית-עליונה של התיבה, נמדדת בנקודות מתחתית העמוד |
ערכי החזרה
| 0 | הפרמטרים FileHandle או PageRef לא היו תקינים |
|---|---|
| 1 | Success |