ApplyRepeatedPageFragment
تخطيط الصفحة، PDF المُعلَّم، الأداء
الوصف
يضع Form XObject ملتقطًا واحدًا على كل صفحة محددة مع وسمل كل توضع أثرًا جانبيًا خارج شجرة البنية المنطقية
يتشارك التدفق الملتقط وموارده كل التوضعات، متجنبة بناء ترويسات وتسميات مجموعات وخلفيات وفهرسات وعلامات مائية وقطع زخرفية مطابقة مرارًا
الصيغة
Delphi
Function TPDFlib.ApplyRepeatedPageFragment(CaptureID: Integer;
Const PageRange: WideString; Left, Top, Width, Height: Double;
Const ArtifactType, ArtifactSubtype: WideString): Integer;ActiveX
Function PDFlib::ApplyRepeatedPageFragment(CaptureID As Long,
PageRange As String, Left As Double, Top As Double, Width As Double,
Height As Double, ArtifactType As String,
ArtifactSubtype As String) As LongDLL
int DLApplyRepeatedPageFragment(int InstanceID, int CaptureID,
const wchar_t* PageRange, double Left, double Top, double Width,
double Height, const wchar_t* ArtifactType,
const wchar_t* ArtifactSubtype);
int DLApplyRepeatedPageFragmentA(int InstanceID, int CaptureID,
const char* PageRange, double Left, double Top, double Width,
double Height, const char* ArtifactType,
const char* ArtifactSubtype);المعاملات
| CaptureID | التقاط قابل لإعادة الاستخدام أعادته EndFormXObject أو واجهة التقاط Form أخرى في المستند الحالي |
|---|---|
| PageRange | تعبير نطاق صفحات، أو سلسلة فارغة لكل صفحة |
| Left, Top, Width, Height | مستطيل التموضع الممرر إلى DrawCapturedPage; يجب أن تكون الإحداثيات منتهية والأبعاد موجبة |
| ArtifactType | إحدى القيم Pagination أو Layout أو Page أو Background الخاصة بـ PDF 2.0 |
| ArtifactSubtype | فارغ ما لم يكن ArtifactType يساوي Pagination; القيم القياسية المقبولة هي Header و Footer و Watermark و PageNum و LineNum و Redaction و Bates |
قيم الإرجاع
تُرجع عدد الصفحات التي وُضع عليها الجزء، أو 0 عند فشل التحقق أو فراغ النطاق أو عجز نطاق API الحالي عن تعديل الصفحات
ملاحظات
تحفظ الدالة الصفحة المحددة من المستدعي وحالة الرسامترفع القيم
Background وPageNum وLineNum وRedaction وBates ترفع إصدار ميزات المخرجات إلى PDF 2.0
التوضعات المتكررة أثر جانبي دائمًا؛ ارسم ظهورًا دلاليًا منفصلًا خارج هذا الاستدعاء عندما ينتمي الظهور الأول إلى ترتيب القراءة
مثال
PDF.BeginFormXObject(0, 0, 180, 24);
PDF.PrintText(0, 8, 'Confidential draft');
FragmentID:= PDF.EndFormXObject;
if PDF.ApplyRepeatedPageFragment(FragmentID, '2-end', 36, 806,
180, 24, 'Pagination', 'Header')= 0 then
HandleLayoutError;