SetSignProcessAppearanceTemplate

Securitate și semnături

Descriere

Configurează un șablon de aspect textual vizibil pentru un proces de semnătură digitală

Șablonul este extins o singură dată când semnătura este produsă, astfel încât același aspect poate fi refolosit cu metadate de semnare și valori de aplicație diferite

Sintaxă

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);

Parametri

SignProcessID	Valoare returnată de o funcție `NewSignProcessFrom*`
TemplateText	Text și sfârșituri de linie care conțin oricare dintre placeholderele integrate `{signer}`, `{reason}`, `{location}`, `{contact}`, `{date}`, `{field}` și `{page}`, plus nume custom înregistrate cu SetSignProcessAppearanceVariable
SignerName	Value substituted for `{signer}`
DateFormat	Format de dată și oră Delphi folosit de `{date}`, sau un șir vid pentru `yyyy-mm-dd hh:nn:ss`
FontSize	Dimensiunea fontului în puncte, sau `0` pentru a potrivi automat blocul de text
FontRed, FontGreen, FontBlue	Componentele de culoare ale textului, în intervalul `0..1`

Valori returnate

1	Șablonul a fost acceptat
0	ID-ul procesului, sintaxa de acolade, numele placeholder-ului, lungimea șablonului, numărul de placeholder-e sau formatul de dată era invalid

Observații

Folosiți {{ și }} pentru a emite acolade literaleUn șablon poate conține cel mult 32.768 de caractere și 256 de apariții de placeholder

Variabilele personalizate lipsă se expandează în text gol, în timp ce variabilele integrate reflectă întotdeauna procesul de semnare curent Apelarea SetSignProcessAppearanceText ulterior selectează din nou aspectul legacy pe linii

Imaginea de câmp are totuși prioritate, iar procesele de timestamp de document nu randează un aspect textual

Vedeți și

SetSignProcessAppearanceVariable, SetSignProcessAppearanceText, SetSignProcessFieldBounds