SetSignProcessAppearanceTemplate

אבטחה וחתימות

תיאור

Configures a visible text appearance template for a digital signature process

את התבנית מרחיבים פעם אחת כשהחתימה נוצרת, כך שאת אותה פריסה אפשר לעשות בה שימוש חוזר עם metadata חתימה וערכי יישום שונים

תחביר

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	Value returned by a `NewSignProcessFrom*` function
TemplateText	Text and line breaks containing any of the built-in placeholders `{signer}`, `{reason}`, `{location}`, `{contact}`, `{date}`, `{field}`, and `{page}`, plus custom names registered with SetSignProcessAppearanceVariable
SignerName	Value substituted for `{signer}`
DateFormat	Delphi date and time format used by `{date}`, or an empty string for `yyyy-mm-dd hh:nn:ss`
FontSize	Font size in points, or `0` to fit the text block automatically
FontRed, FontGreen, FontBlue	Text colour components in the range `0..1`

ערכים מוחזרים

1	The template was accepted
0	מזהה ה-process, תחביר הסוגריים המסולסלים, שם ה-placeholder, אורך התבנית, ספירת ה-placeholders או פורמט התאריך לא היו תקינים

הערות

Use {{ and }} to emit literal bracesA template can contain up to 32,768 characters and 256 placeholder occurrences

משתני טופס מותאמים חסרים מתרחבים לטקסט ריק, בעוד שמשתנים מובנים תמיד משקפים את תהליך החתימה הנוכחי; קריאה מאוחרת יותר ל-SetSignProcessAppearanceText בוחרת שוב במראה השורות המיושן

A field image still takes precedence, and document time-stamp processes do not render a text appearance

ראה גם

SetSignProcessAppearanceVariable, SetSignProcessAppearanceText, SetSignProcessFieldBounds