CapturePageEx

دستکاری صفحه

توضیحات

این تابع صفحه‌ای را «می‌گیرد». پس از گرفته شدن صفحه می‌توان آن را روی صفحات دیگر رسم کرد. برای ترکیب صفحات مختلف یا جای‌گذاری بیش از یک صفحهٔ اصلی روی صفحهٔ دیگر (imposition) مفید است. پس از گرفته شدن صفحه از سند حذف می‌شود؛ اگر می‌خواهید صفحه در سند بماند باید صفحهٔ خالی بسازید و صفحهٔ گرفته‌شده را روی آن رسم کنید

همچنین چون سند همیشه دست‌کم باید یک صفحه داشته باشد نمی‌توان صفحه‌ای را گرفت که تنها صفحهٔ سند باشد؛ در این حالت باید پیش از گرفتن صفحهٔ موجود یک صفحهٔ خالی جدید اضافه کنید

CapturePageEx صفحهٔ گرفته‌شده را از سند جاری‌اش حذف می‌کند؛ برای حفظ صفحهٔ منبع یا واردکردن آن از سند باز دیگر از ImportPageAsFormXObject استفاده کنید

«جعبهٔ رسانه» صفحه به‌عنوان مستطیل دربرگیرندهٔ صفحهٔ گرفته‌شده استفاده می‌شود؛ در حالت‌هایی که باید «جعبهٔ برش» صفحه استفاده شود می‌توان از تابع CapturePageEx استفاده کرد

نحو

Delphi

Function TPDFlib.CapturePageEx(Page, Options: Integer): Integer;

ActiveX

Function PDFlib::CapturePageEx(Page As Long, Options As Long) As Long

DLL

int DLCapturePageEx(int InstanceID, int Page, int Options);

پارامترها

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