AddPageFooter

معالجة الصفحات، التعليقات

الوصف

يختم سطر تذييل جارٍ على صفحة واحدة أو أكثر من المستند المحدد. يُرسم النص بوضع التراكب بالخط المحدد حاليًا، وتُوسَّع رموز الختم مثل <%PageNo%> في مواجهة كل صفحة هدف قبل قياس السطر، ويُحاط السطر المختوم بنتيجة اصطناعية للترقيم من النوع الفرعي Footer حتى تعاملها قرّاء PDF الموسوم بوصفها عنصرًا ثابتًا من عناصر الصفحة لا محتوى مكررًا

الصيغة

Delphi

Function TPDFlib.AddPageFooter(Const PageRange, Text: WideString;
  Margin, Opacity: Double; Alignment: Integer): Integer;

المعاملات

PageRangeتعبير نطاق صفحات، أو سلسلة فارغة تعني كل الصفحات
Textنص التذييل؛ تتوسع الرموز التي يفهمها ExpandStampTokens في مواجهة كل صفحة هدف
Marginالمسافة من الحافة السفلى للصفحة إلى سطر التذييل، بالنقاط وفق مقاس PDF
Opacityعتامة النص بين 0 و1، حيث ترسم القيمة 1 نصًا معتمًا تمامًا
Alignmentالقيمة 0 تحاذي يسارًا عند الهامش، والقيمة 1 توسّط بين الهامشين، والقيمة 2 تحاذي يمينًا مع الاحتفاظ بمسافة الهامش من الحافة اليمنى

القيم المُعادة

عدد الصفحات التي خُتم عليها التذييل، أو 0 حين لا يكون هناك مستند محدد، أو يكون Text فارغًا، أو يتعذّر تحديد أي صفحة من النطاق

ملاحظات

يُقاس السطر بالخط والحجم الحاليين، فاستدعِ SelectFont أولًا؛ ويبقى المحتوى الموجود أصلًا على الصفحة مرئيًا تحت الطبقة المتراكبة. وتُستعاد الصفحة المحددة عند عودة الاستدعاء

لأدوار تذييلات الصفحة الأولى والفردية والزوجية مع دعم محتوى HTML انظر ApplyPageHeaderFooterSet

مثال

PDF.SelectFont(PDF.AddStandardFont(sfHelvetica));
PDF.AddPageFooter('', '<%ShortDate%> - <%PageNo%>/<%TotalPages%>', 24, 0.8, 2);