SetSignProcessAppearanceText

Zabezpieczenia i podpisy

Opis

Tworzy automatycznie generowany widoczny wygląd tekstowy pola podpisu dla wskazanego procesu podpisu cyfrowego. Maska bitowa Options wybiera wyświetlane wiersze: nazwę podpisującego, przyczynę i lokalizację podane przez SetSignProcessInfo oraz datę podpisania, opcjonalnie poprzedzone etykietami opisowymi, takimi jak "Podpisano przez:" i "Przyczyna:"

Blok tekstu jest układany wewnątrz prostokąta pola podpisu (zobacz SetSignProcessFieldBounds) przy użyciu standardowej czcionki Helvetica. Gdy FontSize wynosi 0, rozmiar jest automatycznie dopasowywany do pola. Obraz ustawiony za pomocą SetSignProcessFieldImageFromFile ma pierwszeństwo przed postacią tekstową, a procesy znacznika czasu dokumentu ją ignorują

Składnia

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

Parametry

SignProcessID	Wartość zwrócona przez funkcję NewSignProcessFromFile, NewSignProcessFromStream lub NewSignProcessFromString
Options	Maska bitowa wybierająca wiersze tekstu: 1 = nazwa podpisującego (parametr SignerName), 2 = powód, 4 = lokalizacja (obie wartości z SetSignProcessInfo), 8 = data podpisania, 16 = etykiety opisowe przed każdym wierszem. 0 wyłącza postać tekstową
SignerName	Nazwa wyświetlana w wierszu podpisującego, gdy ustawiony jest bit 1
FontSize	Rozmiar czcionki w punktach; 0 automatycznie dopasowuje blok tekstu do prostokąta pola podpisu
FontRed, FontGreen, FontBlue	Składowe koloru tekstu w zakresie 0..1

Wartości zwracane

0	Uchwyt procesu podpisywania był nieprawidłowy
1	Powodzenie