SetSignProcessAppearanceTemplate

Sicurezza e firme

Descrizione

Configura un modello di aspetto testuale visibile per un processo di firma digitale

Il modello viene espanso una volta alla produzione della firma, così lo stesso layout può essere riutilizzato con metadati e valori applicativi diversi

Sintassi

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	Valore restituito da una funzione `NewSignProcessFrom*`
TemplateText	Testo e interruzioni di riga contenenti uno qualsiasi dei segnaposto incorporati `{signer}`, `{reason}`, `{location}`, `{contact}`, `{date}`, `{field}` e `{page}`, oltre ai nomi personalizzati registrati con SetSignProcessAppearanceVariable
SignerName	Valore sostituito a `{signer}`
DateFormat	Formato data e ora Delphi usato da `{date}` oppure stringa vuota per `yyyy-mm-dd hh:nn:ss`
FontSize	Dimensione del font in punti oppure `0` per adattare automaticamente il blocco di testo
FontRed, FontGreen, FontBlue	Componenti del colore del testo nell'intervallo `0..1`

Valori restituiti

1	Il modello è stato accettato
0	ID processo, sintassi parentesi, nome segnaposto, lunghezza modello, numero segnaposto o formato data non valido

Note

Usare {{ e }} per produrre parentesi graffe letterali

Un modello può contenere fino a 32.768 caratteri e 256 occorrenze di segnaposto

Le variabili personalizzate mancanti diventano testo vuoto, quelle integrate riflettono sempre il processo corrente

Una chiamata successiva a SetSignProcessAppearanceText seleziona nuovamente l'aspetto legacy basato su righe

L'immagine del campo ha priorità e i timestamp documento non generano un aspetto testuale

Vedere anche

SetSignProcessAppearanceVariable, SetSignProcessAppearanceText, SetSignProcessFieldBounds