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 Long

DLL

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;