SetSignProcessAppearanceTemplate

الأمان والتواقيع

الوصف

يهيئ قالب مظهر نصي مرئي لعملية توقيع رقمي

139يتمدد القالب مرة واحدة عند إنتاج التوقيع فيمكن إعادة استخدام التخطيط نفسه ببيانات توقيع وقيم تطبيق مختلفة

الصيغة

Delphi

Function TPDFlib.SetSignProcessAppearanceTemplate(SignProcessID: Integer; Const TemplateText, SignerName, DateFormat: WideString; FontSize, FontRed, FontGreen, FontBlue: Double): Integer;

ActiveX

Function PDFlib::SetSignProcessAppearanceTemplate(SignProcessID As Long, TemplateText As String, SignerName As String, DateFormat As String, FontSize As Double, FontRed As Double, FontGreen As Double, FontBlue As Double) As Long

DLL

int DLSetSignProcessAppearanceTemplate(int InstanceID, int SignProcessID, const wchar_t * TemplateText, const wchar_t * SignerName, const wchar_t * DateFormat, double FontSize, double FontRed, double FontGreen, double FontBlue);

المعاملات

SignProcessID	قيمة تُرجعها إحدى دوال `NewSignProcessFrom*`
TemplateText	نص وفواصل أسطر تحتوي أيًا من العناصر النائبة المدمجة `{signer}` و`{reason}` و`{location}` و`{contact}` و`{date}` و`{field}` و`{page}`، إضافة إلى أسماء مخصصة مسجلة بـ SetSignProcessAppearanceVariable
SignerName	القيمة المستبدلة لـ `{signer}`
DateFormat	تنسيق تاريخ ووقت Delphi المستخدم من `{date}`، أو سلسلة فارغة لـ `yyyy-mm-dd hh:nn:ss`
FontSize	حجم الخط بالنقاط، أو `0` لملاءمة كتلة النص تلقائيًا
FontRed, FontGreen, FontBlue	مركّبات لون النص في المدى `0..1`

قيم الإرجاع

1	قُبل القالب
0	كان معرف العملية أو صياغة الأقواس أو اسم العنصر النائب أو طول القالب أو عدد العناصر النائبة أو تنسيق التاريخ غير صالح

ملاحظات

استخدم {{ و}} لإصدار أقواس حرفيةيمكن أن يحتوي القالب حتى 32,768 محرفًا و256 ظهورًا للعناصر النائبة

تتمدد المتغيرات المخصصة الناقصة إلى نص فارغ، بينما تعكس المتغيرات المدمجة دائمًا عملية التوقيع الحاليةاستدعاء SetSignProcessAppearanceText لاحقًا يعيد اختيار مظهر الإرث القائم على الأسطر

متغيرات المستخدم المخصصة المفقودة تتوسع نصًا فارغًا، بينما تعكس المتغيرات المدمجة دائمًا عملية التوقيع الحالية

الاستدعاء اللاحق لـ SetSignProcessAppearanceText يعيد اختيار المظهر السطري القديم

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

انظر أيضًا

SetSignProcessAppearanceVariable, SetSignProcessAppearanceText, SetSignProcessFieldBounds