SetSignProcessAppearanceTemplate

Sicherheit und Signaturen

Beschreibung

Konfiguriert eine Vorlage für die sichtbare Textdarstellung eines digitalen Signaturvorgangs

Die Vorlage wird einmal beim Erzeugen der Signatur erweitert, sodass dasselbe Layout mit unterschiedlichen Signaturmetadaten und Anwendungswerten wiederverwendet werden kann

Syntax

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

Parameter

SignProcessID	Von einer `NewSignProcessFrom*`-Funktion zurückgegebener Wert
TemplateText	Text und Zeilenumbrüche mit einem oder mehreren der integrierten Platzhalter `{signer}`, `{reason}`, `{location}`, `{contact}`, `{date}`, `{field}` und `{page}` sowie mit SetSignProcessAppearanceVariable registrierte benutzerdefinierte Namen
SignerName	Für `{signer}` eingesetzter Wert
DateFormat	Von `{date}` verwendetes Delphi-Datums- und Zeitformat oder eine leere Zeichenfolge für `yyyy-mm-dd hh:nn:ss`
FontSize	Schriftgröße in Punkten oder `0`, um den Textblock automatisch einzupassen
FontRed, FontGreen, FontBlue	Textfarbkomponenten im Bereich `0..1`

Rückgabewerte

1	Die Vorlage wurde akzeptiert
0	Prozess-ID, Klammersyntax, Platzhaltername, Vorlagenlänge, Platzhalteranzahl oder Datumsformat war ungültig

Anmerkungen

Verwenden Sie {{ und }}, um literale geschweifte Klammern auszugeben

Eine Vorlage kann bis zu 32.768 Zeichen und 256 Platzhaltervorkommen enthalten

Fehlende benutzerdefinierte Variablen werden zu leerem Text erweitert, während integrierte Variablen stets den aktuellen Signaturprozess widerspiegeln

Ein späterer Aufruf von SetSignProcessAppearanceText wählt wieder die ältere zeilenbasierte Darstellung aus

Ein Feldbild hat weiterhin Vorrang, und Dokumentzeitstempelprozesse rendern kein Texterscheinungsbild

Siehe auch

SetSignProcessAppearanceVariable, SetSignProcessAppearanceText, SetSignProcessFieldBounds