SetSignProcessAppearanceTemplate

Säkerhet och signaturer

Beskrivning

Configures a visible text appearance template for a digital signature process

Mallen expanderas en gång när signaturen produceras, så samma layout kan återanvändas med olika signeringsmetadata och programvärden

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

Parametrar

SignProcessID	Värde som returneras av en `NewSignProcessFrom*`-funktion
TemplateText	Text och radbrytningar som innehåller någon av de inbyggda platshållarna `{signer}`, `{reason}`, `{location}`, `{contact}`, `{date}`, `{field}` och `{page}`, plus anpassade namn registrerade med SetSignProcessAppearanceVariable
SignerName	Value substituted for `{signer}`
DateFormat	Delphi-datum- och tidsformat som `{date}` använder, eller en tom sträng för `yyyy-mm-dd hh:nn:ss`
FontSize	Textstorlek i punkter, eller `0` för att anpassa textblocket automatiskt
FontRed, FontGreen, FontBlue	Textfärgkomponenter i intervallet `0..1`

Returvärden

1	Mallen godkändes
0	Process-id, klammar-syntax, platshållarnamn, mallängd, platshållarantal eller datumformat var ogiltigt

Anmärkningar

Använd {{ och }} för att generera literala klamrarEn mall kan innehålla upp till 32 768 tecken och 256 platshållarförekomster

Saknade anpassade variabler expanderar till tom text, medan inbyggda variabler alltid speglar den aktuella signeringsprocessenEtt senare anrop av SetSignProcessAppearanceText väljer det äldre radbaserade utseendet igen

En fältbild går ändå före, och dokumentets tidsstämpelprocesser renderar inget textutseende

Ett senare anrop av SetSignProcessAppearanceText väljer åter det äldre radvisade utseendet

En fältbild har fortfarande företräde, och dokumenttidsstämpelprocesser renderar inget textutseende

Se även

SetSignProcessAppearanceVariable, SetSignProcessAppearanceText, SetSignProcessFieldBounds