DASetPageBox
وظائف الوصول المباشر، خصائص الصفحة
الوصف
يضبط أبعاد صناديق حدود الصفحة المحددة. ويمثل MediaBox الوسيط الفيزيائي للصفحة
يمثل CropBox المنطقة المرئية من الصفحة وسيُقتطع المحتوى على هذه المنطقة. أما BleedBox فشبيه بـ CropBox لكنه المستطيل المستخدم في بيئة الإنتاج
يشير TrimBox إلى الأبعاد المقصودة للصفحة النهائية بعد القص، ويحدد ArtBox مدى المحتوى ذي المعنى في الصفحة كما قصده منشئ الصفحة
سلوك إصدار PDF: تتطلب مدخلات قاموس صفحة BleedBox وTrimBox وArtBox إصدار PDF 1.3. وعندما يعدل الوصول المباشر مصدرًا بإصدار أقل ولم يكن إصدار الحفظ مقفلًا يرفع 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 | مقبض تُرجعه الدالات 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 |