SetSignProcessAppearanceTemplate

Sikkerhed og signaturer

Beskrivelse

Konfigurerer en synlig tekstudseendeskabelon til en digital signeringsproces

Skabelonen udvides én gang, når signaturen frembringes, så det samme layout kan genbruges med forskellige signeringsmetadata og programværdier

Syntaks

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

Parametre

SignProcessID	Værdi returneret af en `NewSignProcessFrom*`-funktion
TemplateText	Tekst og linjeskift, der indeholder en eller flere af de indbyggede pladsholdere `{signer}`, `{reason}`, `{location}`, `{contact}`, `{date}`, `{field}` og `{page}` samt brugerdefinerede navne registreret med SetSignProcessAppearanceVariable
SignerName	Værdi, der erstatter `{signer}`
DateFormat	Delphi-dato- og tidsformat, der bruges af `{date}`, eller en tom streng for `yyyy-mm-dd hh:nn:ss`
FontSize	Skriftstørrelse i punkter eller `0` for automatisk at tilpasse tekstblokken
FontRed, FontGreen, FontBlue	Tekstfarvekomponenter i intervallet `0..1`

Returværdier

1	Skabelonen blev accepteret
0	Proces-id'et, klammesyntaksen, pladsholdernavnet, skabelonlængden, pladsholderantallet eller datoformatet var ugyldigt

Bemærkninger

Brug {{ og }} til at udsende bogstavelige klammer

En skabelon kan indeholde op til 32.768 tegn og 256 forekomster af pladsholdere

Manglende brugerdefinerede variabler udvides til tom tekst, mens indbyggede variabler altid afspejler den aktuelle signeringsproces

Et senere kald til SetSignProcessAppearanceText vælger igen den ældre linjebaserede appearance

Et feltbillede har stadig forrang, og dokumenttidsstempelprocesser gengiver ikke et tekstudseende

Se også

SetSignProcessAppearanceVariable, SetSignProcessAppearanceText, SetSignProcessFieldBounds