CapturePageEx

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

الوصف

تلتقط هذه الدالة صفحة. فبعد التقاط الصفحة يمكن رسمها على صفحات أخرى، وهو مفيد لدمج صفحات مختلفة أو وضع أكثر من صفحة أصلية على صفحة أخرى (الإخراج). وبعد التقاط الصفحة تزال من المستند؛ وإذا أردت بقاء الصفحة في المستند فعليك إنشاء صفحة فارغة ورسم الصفحة الملتقطة عليها

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

يزيل 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);

المعاملات

Pageرقم الصفحة المراد التقاطها. الصفحة الأولى في المستند هي الصفحة 1
Options0 = استخدام صندوق وسائط الصفحة للمستطيل المحيط 1 = استخدام صندوق قص الصفحة للمستطيل المحيط إذا كان له واحد، وإلا استخدام صندوق الوسائط 2 = استخدام صندوق bleed للصفحة للمستطيل المحيط إذا كان له واحد، وإلا استخدام صندوق القص 3 = استخدام صندوق trim للصفحة للمستطيل المحيط إذا كان له واحد، وإلا استخدام صندوق القص 4 = استخدام صندوق art للصفحة للمستطيل المحيط إذا كان له واحد، وإلا استخدام صندوق القص

قيم الإرجاع

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