CapturePage

دستکاری صفحه

توضیحات

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

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

با CapturePage نمی‌توان صفحاتی را از سندی به سند جدید دیگری منتقل کرد، پس پیش از فراخوانی CapturePage باید همهٔ صفحات مورد نیاز در یک سند ادغام شوند. CaptureID فقط اشاره‌گری به صفحه‌ای پنهان است، بنابراین حافظه‌ای لازم نیست آزاد شود

«media box» صفحه به‌عنوان مستطیل محدودکنندهٔ صفحهٔ ضبط‌شده استفاده می‌شود. برای مواردی که باید «crop box» صفحه استفاده شود می‌توان از تابع CapturePage استفاده کرد

نحو

Delphi

Function TPDFlib.CapturePage(Page: Integer): Integer;

ActiveX

Function PDFlib::CapturePage(Page As Long) As Long

DLL

int DLCapturePage(int InstanceID, int Page);

پارامترها

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