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 LongDLL
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 | اسم غير حساس لحالة الأحرف تشترك فيه المتغيرات المنتمية لمجموعة قوالب واحدة |
|---|---|
| VariantName | Text قالب منتهٍ بـ null بترميز إدخال ANSI للمثيل وتتطابق جميع المعاملات الأخرى مع AddPageNumberPlaceholder |
| Text | نص أو قالب HTML يتمدد بشكل منفصل عن كل صفحة محددة؛ وتنشئ القيمة الفارغة متغيرًا فارغًا صريحًا يكبح التراجع |
| Margin | مسافة غير سالبة من حافة الصفحة ذات الصلة |
| Height | ارتفاع صندوق المحتوى، أو 0 لقياس سطر النص الخام أو محتوى HTML تلقائيًا |
| Opacity | قيمة من 0 للشفاف إلى 1 للمعتم |
| Alignment | 0 يعطّل التنظيف؛ وتزيل القيم من 1 إلى 8 البكسلات السوداء ذات الجيران السود الأقل في منطقة 3x3 المحيطة |
| IsHeader | 1 = الإحداثي الأفقي للزاوية السفلية اليسرى 2 = الإحداثي الرأسي للزاوية السفلية اليسرى 3 = الإحداثي الأفقي للزاوية السفلية اليمنى 4 = الإحداثي الرأسي للزاوية السفلية اليمنى 5 = الإحداثي الأفقي للزاوية العلوية اليمنى 6 = الإحداثي الرأسي للزاوية العلوية اليمنى 7 = الإحداثي الأفقي للزاوية العلوية اليسرى 8 = الإحداثي الرأسي للزاوية العلوية اليسرى |
| RichText | 1 عند النجاح، وإلا 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);