SetSignProcessAppearanceText

Sikkerhed og signaturer

Beskrivelse

Opbygger en automatisk genereret synlig tekstvisning for signaturfeltet i den angivne digitale signeringsproces. Bitmasken Options vælger, hvilke linjer der vises: underskriverens navn, årsagen og placeringen angivet via SetSignProcessInfo samt signeringsdatoen, eventuelt med beskrivende præfikser som "Signed by:" og "Reason:"

Tekstblokken layoutes inden for signaturfeltets rektangel (se SetSignProcessFieldBounds) med standardskrifttypen Helvetica. Når FontSize er 0, tilpasses størrelsen automatisk til feltet. Et billede indstillet via SetSignProcessFieldImageFromFile har forrang for tekstudseendet, og dokumenttidsstempelprocesser ignorerer det.

Syntaks

Delphi

Function TPDFlib.SetSignProcessAppearanceText(SignProcessID, Options: Integer; Const SignerName: WideString; FontSize, FontRed, FontGreen, FontBlue: Double): Integer;

ActiveX

Function PDFlib::SetSignProcessAppearanceText(SignProcessID As Long, Options As Long, SignerName As String, FontSize As Double, FontRed As Double, FontGreen As Double, FontBlue As Double) As Long

DLL

int DLSetSignProcessAppearanceText(int InstanceID, int SignProcessID, int Options, const wchar_t * SignerName, double FontSize, double FontRed, double FontGreen, double FontBlue);

Parametre

SignProcessID	En værdi returneret af funktionerne NewSignProcessFromFile, NewSignProcessFromStream eller NewSignProcessFromString.
Options	Bitmaske, der vælger tekstlinjerne: 1 = underskriverens navn (parameteren SignerName), 2 = begrundelse, 4 = placering (begge fra SetSignProcessInfo), 8 = underskriftsdato, 16 = beskrivende etiketter foran hver linje. 0 deaktiverer tekstudseendet
SignerName	Navnet, der vises på underskriverens navnelinje, når bit 1 er angivet.
FontSize	Skriftstørrelse i punkter; 0 tilpasser automatisk tekstblokken til signaturfeltets rektangel.
FontRed, FontGreen, FontBlue	Tekstfarvekomponenter i intervallet 0..1.

Returværdier

0	Handlen til signeringsprocessen var ikke gyldig
1	Success