DACapturePageEx

قابلیت دسترسی مستقیم، دستکاری صفحه

توضیحات

صفحهٔ مشخص‌شده را از سندی که در اصل با DAOpenFile باز شده ضبط می‌کند؛ صفحهٔ ضبط‌شده پنهان می‌شود اما سپس می‌توان آن را با تابع DADrawCapturedPage روی هر صفحهٔ دیگری رسم کرد. «media box» صفحه به‌عنوان مستطیل محدودکنندهٔ صفحهٔ ضبط‌شده استفاده می‌شود. برای مواردی که باید «crop box» صفحه استفاده شود می‌توان از تابع DACapturePageEx استفاده کرد

نحو

Delphi

Function TPDFlib.DACapturePageEx(FileHandle, PageRef, Options: Integer): Integer;

ActiveX

Function PDFlib::DACapturePageEx(FileHandle As Long, PageRef As Long, Options As Long) As Long

DLL

int DLDACapturePageEx(int InstanceID, int FileHandle, int PageRef, int Options);

پارامترها

FileHandleهندلی که توسط توابع DAOpenFile، DAOpenFileReadOnly یا DAOpenFromStream بازگردانده می‌شود
PageRefیک مرجع صفحه که توابع DAFindPage یا DANewPage برمی‌گردانند
Options0 = استفاده از media box صفحه برای مستطیل محدودکننده 1 = استفاده از crop box صفحه برای مستطیل محدودکننده اگر داشته باشد، وگرنه media box 2 = استفاده از bleed box صفحه اگر داشته باشد، وگرنه crop box 3 = استفاده از trim box صفحه اگر داشته باشد، وگرنه crop box 4 = استفاده از art box صفحه اگر داشته باشد، وگرنه crop box

مقادیر بازگشتی

0FileHandle یا PageRef مشخص‌شده معتبر نبود، یا صفحه مشخص‌شده تنها صفحه سند بود
Non-zeroشناسه‌ای که با تابع DADrawCapturedPage قابل استفاده است