CapturePage

معالجة الصفحة

الوصف

هذه الدالة "تلتقط" صفحة. وبمجرد التقاط الصفحة يمكن

كذلك، لأنه يجب أن يمتلك المستند صفحة واحدة على الأقل في كل الأوقات، يتعذر التقاط صفحة إذا كانت الصفحة الوحيدة في المستند. في هذه الحالة عليك إضافة صفحة فارغة جديدة قبل أن يمكن التقاط الصفحة القائمة

لا يمكنك استخدام CapturePage لنقل الصفحات من مستند إلى مستند جديد آخر فيجب دمج جميع الصفحات المطلوبة في مستند واحد قبل استدعاء CapturePage. وقيمة CaptureID مجرد مؤشر إلى صفحة مخفية لذا لا يلزم تحرير الذاكرة

يُستخدم "صندوق الوسائط" للصفحة كمستطيل محيط للصفحة الملتقطة. ويمكن استخدام الدالة CapturePage في الحالات التي ينبغي فيها استخدام "صندوق القص" للصفحة بدلًا من ذلك

الصيغة

Delphi

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

ActiveX

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

DLL

int DLCapturePage(int InstanceID, int Page);

المعاملات

Pageرقم الصفحة المطلوب التقاطها. أول صفحة في المستند هي الصفحة 1

قيم الإرجاع

0100الصفحة المحددة غير موجودة أو أنها الصفحة الوحيدة في المستند
Non-zeroمعرف عملية الالتقاط. ويجب تزويد هذا المعرّف إلى الدالة DrawCapturedPage