SetSignProcessAppearanceTextA

Security and Signatures

Description

Koncové A označuje vstupný bod ANSI (char) knižnice DLL; rozhranie ActiveX/COM sprístupňuje iba formu Unicode. Správanie je rovnaké ako pri SetSignProcessAppearanceText a reťazcové argumenty sa interpretujú pomocou aktuálnej znakovej stránky nastavenej funkciou SetAnsiMode

Zostaví automaticky generovaný viditeľný textový vzhľad pre podpisové pole zadanej digitalizačnej podpisovej procedúry. Bitová maska Options vyberá, ktoré riadky sa objavia: meno podpisovateľa, dôvod a miesto dodané cez SetSignProcessInfo a dátum podpisu, voliteľne s popisnými nálepkami ako Signed by: a Reason:

Textový blok sa rozloží vnútri obdĺžnika podpisového poľa (pozri SetSignProcessFieldBounds) štandardným fontom Helvetica. Pri FontSize 0 sa veľkosť automaticky prispôsobí poľu. Obrázok nastavený cez SetSignProcessFieldImageFromFile má prednosť pred textovým vzhľadom a procesy časových pečiatok dokumentu ho ignorujú

Syntax

Delphi

Function DLSetSignProcessAppearanceTextA(InstanceID, SignProcessID, Options: Integer; SignerName: PAnsiChar; FontSize, FontRed, FontGreen, FontBlue: Double): Integer;

DLL

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

Parameters

SignProcessIDA value returned by the NewSignProcessFromFile, NewSignProcessFromStream or NewSignProcessFromString functions.
OptionsBit mask selecting the text lines: 1 = signer name (the SignerName parameter), 2 = reason, 4 = location (both from SetSignProcessInfo), 8 = signing date, 16 = descriptive labels in front of each line. 0 disables the text appearance.
SignerNameThe name shown on the signer name line when bit 1 is set.
FontSizeFont size in points; 0 fits the text block to the signature field rectangle automatically.
FontRed, FontGreen, FontBlueText colour components in the range 0..1.

Return values

0The sign process handle was not valid
1Success