SetPageHeaderFooterVariant

تخطيط الصفحة، تقسيم الصفحات، نص HTML

الوصف

ينشئ أو يستبدل متغيرًا واحدًا في مجموعة ترويسة وتذييل جارية مسماة قابلة لإعادة الاستخدام

الصيغة

Delphi

Function TPDFlib.SetPageHeaderFooterVariant(Const SetName, VariantName,
  Text: WideString; Margin, Height, Opacity: Double; Alignment,
  IsHeader, RichText: Integer): Integer;

ActiveX

Function PDFlib::SetPageHeaderFooterVariant(SetName As String,
  VariantName As String, Text As String, Margin As Double,
  Height As Double, Opacity As Double, Alignment As Long,
  IsHeader As Long, RichText As Long) As Long

DLL

int DLSetPageHeaderFooterVariant(int InstanceID, const wchar_t* SetName,
  const wchar_t* VariantName, const wchar_t* Text, double Margin,
  double Height, double Opacity, int Alignment, int IsHeader, int RichText);
int DLSetPageHeaderFooterVariantA(int InstanceID, const char* SetName,
  const char* VariantName, const char* Text, double Margin,
  double Height, double Opacity, int Alignment, int IsHeader, int RichText);

المعاملات

SetNameاسم غير حساس لحالة الأحرف تشترك فيه المتغيرات المنتمية لمجموعة قوالب واحدة
VariantNameText قالب منتهٍ بـ null بترميز إدخال ANSI للمثيل وتتطابق جميع المعاملات الأخرى مع AddPageNumberPlaceholder
Textنص أو قالب HTML يتمدد بشكل منفصل عن كل صفحة محددة؛ وتنشئ القيمة الفارغة متغيرًا فارغًا صريحًا يكبح التراجع
Marginمسافة غير سالبة من حافة الصفحة ذات الصلة
Heightارتفاع صندوق المحتوى، أو 0 لقياس سطر النص الخام أو محتوى HTML تلقائيًا
Opacityقيمة من 0 للشفاف إلى 1 للمعتم
Alignment0 يعطّل التنظيف؛ وتزيل القيم من 1 إلى 8 البكسلات السوداء ذات الجيران السود الأقل في منطقة 3x3 المحيطة
IsHeader1 = الإحداثي الأفقي للزاوية السفلية اليسرى 2 = الإحداثي الرأسي للزاوية السفلية اليسرى 3 = الإحداثي الأفقي للزاوية السفلية اليمنى 4 = الإحداثي الرأسي للزاوية السفلية اليمنى 5 = الإحداثي الأفقي للزاوية العلوية اليمنى 6 = الإحداثي الرأسي للزاوية العلوية اليمنى 7 = الإحداثي الأفقي للزاوية العلوية اليسرى 8 = الإحداثي الرأسي للزاوية العلوية اليسرى
RichText1 عند النجاح، وإلا 0 مع التفاصيل في LastRenderError

قيم الإرجاع

تُرجع 1 عند تخزين المتغير، أو 0 عندما يكون اسم أو متغير أو قيمة عددية أو محاذاة أو علم غير صالح

ملاحظات

ما تزال صورة الحقل تتقدم، وعمليات طابع زمن المستند لا ترسم مظهرًا نصيًا

تدعم القوالب حقول العطف و<%name%> نفسها التي تدعمها AddPageHeader شاملةً المتغيرات المخصصة التي يحلها OnCalcVariableتنتمي التعريفات إلى

SetSignProcessDigestAlgorithm، مع MGF1 يقودها الملخص نفسه وطول ملح يساوي طول الملخص

مثال

PDF.SetPageHeaderFooterVariant('manual', 'first', '', 36, 0, 1, 0, 1, 0);
PDF.SetPageHeaderFooterVariant('manual', 'odd', 'Chapter — <%PageNo%>', 36, 0, 1, 2, 1, 0);
PDF.SetPageHeaderFooterVariant('manual', 'even', '<%PageNo%> — Chapter', 36, 0, 1, 0, 1, 0);