SetSignProcessAppearanceText

Sicherheit und Signaturen

Beschreibung

Erstellt für das Signaturfeld des angegebenen digitalen Signaturprozesses eine automatisch erzeugte sichtbare Textdarstellung. Die Optionsbitmaske wählt aus, welche Zeilen erscheinen: Name des Unterzeichners, über SetSignProcessInfo angegebener Grund und Ort sowie Signaturdatum, optional mit beschreibenden Bezeichnern wie "Signed by:" und "Reason:".

Der Textblock wird im Rechteck des Signaturfelds mit der Standardschrift Helvetica gesetzt, siehe SetSignProcessFieldBounds. Wenn FontSize 0 ist, wird die Größe automatisch an das Feld angepasst. Ein mit SetSignProcessFieldImageFromFile festgelegtes Bild hat Vorrang vor der Textdarstellung; Zeitstempelprozesse des Dokuments ignorieren sie

Syntax

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

Parameter

SignProcessID	Ein von den Funktionen NewSignProcessFromFile, NewSignProcessFromStream oder NewSignProcessFromString zurückgegebener Wert
Options	Bitmaske zur Auswahl der Textzeilen: 1 = Name des Signierers, der Parameter SignerName, 2 = Begründung, 4 = Ort, beide aus SetSignProcessInfo, 8 = Signierdatum, 16 = beschreibende Bezeichnungen vor jeder Zeile. 0 deaktiviert die Textdarstellung.
SignerName	Der in der Unterzeichner-Namenszeile angezeigte Name, wenn Bit 1 gesetzt ist.
FontSize	Schriftgröße in Punkt; 0 passt den Textblock automatisch an das Rechteck des Signaturfelds an
FontRed, FontGreen, FontBlue	Textfarbkomponenten im Bereich 0..1

Rückgabewerte

0	Das Signaturprozesshandle war ungültig
1	Success