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
BoxIndex1 = MediaBox 2 = CropBox 3 = BleedBox 4 = TrimBox 5 = ArtBox
X1الإحداثي الأفقي للزاوية السفلية اليسرى للصندوق مقاسًا بالنقاط من الحافة اليسرى للصفحة
Y1الإحداثي الرأسي للزاوية السفلية اليسرى للمربع، مقاسًا بالنقاط من أسفل الصفحة
X2الإحداثي الأفقي للزاوية العلوية اليمنى للصندوق مقاسًا بالنقاط من أسفل الصفحة
Y2الإحداثي الرأسي للزاوية العلوية اليمنى للصندوق مقاسًا بالنقاط من

قيم الإرجاع

0كان معامل FileHandle أو PageRef غير صالح
1Success