DASetPageBox
قابلیت دسترسی مستقیم، ویژگیهای صفحه
توضیحات
ابعاد مستطیلهای مرزی صفحهٔ مشخصشده را تنظیم میکند؛ MediaBox بستر فیزیکی صفحه را نشان میدهد
CropBox ناحیه قابلمشاهده صفحه را مشخص میکند و محتوا به همین ناحیه clip میشود. BleedBox شبیه CropBox است، اما مستطیلی است که در محیط تولید استفاده میشود
TrimBox ابعاد موردنظر صفحه نهایی را پس از برش نشان میدهد و ArtBox گستره محتوای معنادار page's را، آنطور که creator مربوط به page's در نظر گرفته است، تعریف میکند
رفتار نسخهٔ 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 LongDLL
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 | مختصات افقی گوشهٔ پایین-چپ کادر، بر حسب point و اندازهگیریشده از لبهٔ چپ صفحه |
| Y1 | مختصات عمودی گوشه پایینچپ کادر، برحسب point از پایین صفحه |
| X2 | مختصات افقی گوشه بالا-راست کادر که از پایین صفحه و برحسب point اندازهگیری میشود |
| Y2 | مختصات عمودی گوشهٔ بالا-راست کادر، بر حسب point و اندازهگیریشده از پایین صفحه |
مقادیر بازگشتی
| 0 | پارامترهای FileHandle یا PageRef نامعتبر بودند |
|---|---|
| 1 | Success |