SetSignProcessAppearanceTemplate

Zabezpieczenia i podpisy

Opis

Konfiguruje szablon widocznej postaci tekstowej dla procesu podpisu cyfrowego

Szablon jest rozwijany jeden raz podczas tworzenia podpisu, dzięki czemu tego samego układu można używać z różnymi metadanymi podpisu i wartościami aplikacji

Składnia

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

Parametry

SignProcessID	Wartość zwrócona przez funkcję `NewSignProcessFrom*`
TemplateText	Tekst i podziały wierszy zawierające dowolne wbudowane symbole zastępcze `{signer}`, `{reason}`, `{location}`, `{contact}`, `{date}`, `{field}` i `{page}`, a także nazwy niestandardowe zarejestrowane za pomocą SetSignProcessAppearanceVariable
SignerName	Wartość podstawiana za `{signer}`
DateFormat	Format daty i godziny Delphi używany przez `{date}` albo pusty ciąg dla `yyyy-mm-dd hh:nn:ss`
FontSize	Rozmiar czcionki w punktach albo `0`, aby automatycznie dopasować blok tekstu
FontRed, FontGreen, FontBlue	Składowe koloru tekstu w zakresie `0..1`

Wartości zwracane

1	Szablon został zaakceptowany
0	Identyfikator procesu, składnia nawiasów klamrowych, nazwa symbolu zastępczego, długość szablonu, liczba symboli zastępczych lub format daty były nieprawidłowe

Uwagi

Użyj {{ i }}, aby wypisać dosłowne nawiasy klamrowe

Szablon może zawierać do 32 768 znaków i 256 wystąpień symboli zastępczych

Brakujące zmienne niestandardowe są rozwijane do pustego tekstu, natomiast zmienne wbudowane zawsze odzwierciedlają bieżący proces podpisywania

Późniejsze wywołanie SetSignProcessAppearanceText ponownie wybiera starszą postać wierszową

Obraz pola nadal ma pierwszeństwo, a procesy znacznika czasu dokumentu nie renderują postaci tekstowej

Zobacz również

SetSignProcessAppearanceVariable, SetSignProcessAppearanceText, SetSignProcessFieldBounds