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 |
|---|
قيم الإرجاع
| 0 | 100الصفحة المحددة غير موجودة أو أنها الصفحة الوحيدة في المستند |
|---|---|
| Non-zero | معرف عملية الالتقاط. ويجب تزويد هذا المعرّف إلى الدالة DrawCapturedPage |