DACapturePage
قابلیت دسترسی مستقیم، دستکاری صفحه
توضیحات
این تابع صفحهٔ مشخصشده را از سندی که در اصل با DAOpenFile باز شده «ضبط» میکند. سپس میتوان صفحهٔ ضبطشده را با تابع DADrawCapturedPage روی هر صفحهٔ دیگری رسم کرد؛ برای ترکیب صفحات مختلف یا قرار دادن بیش از یک صفحهٔ اصلی روی صفحهٔ دیگر (imposition) کاربرد دارد
پس از ضبط یک صفحه، آن صفحه از سند حذف میشود؛ اگر میخواهید صفحه در سند بماند باید یک صفحهٔ خالی بسازید و صفحهٔ ضبطشده را روی آن رسم کنید
«media box» صفحه بهعنوان مستطیل محدودکنندهٔ صفحهٔ ضبطشده استفاده میشود. برای مواردی که باید «crop box» صفحه استفاده شود میتوان از تابع DACapturePageEx استفاده کرد
نحو
Delphi
Function TPDFlib.DACapturePage(FileHandle, PageRef: Integer): Integer;ActiveX
Function PDFlib::DACapturePage(FileHandle As Long, PageRef As Long) As LongDLL
int DLDACapturePage(int InstanceID, int FileHandle, int PageRef);پارامترها
| FileHandle | هندلی که توسط توابع DAOpenFile، DAOpenFileReadOnly یا DAOpenFromStream بازگردانده میشود |
|---|---|
| PageRef | یک مرجع صفحه که توابع DAFindPage یا DANewPage برمیگردانند |
مقادیر بازگشتی
| 0 | مقدار FileHandle یا PageRef مشخصشده معتبر نبود |
|---|---|
| Non-zero | شناسهای که با تابع DADrawCapturedPage قابل استفاده است |