SetSignProcessAppearanceText
Безопасность и подписи
Описание
Строит автоматически сгенерированный видимый текстовый вид поля подписи для указанного процесса цифровой подписи. Битовая маска Options выбирает строки: имя подписанта, причину и место из SetSignProcessInfo и дату подписания, при желании с пояснительными метками вроде "Signed by:" и "Reason:"
Текстовый блок размещается в прямоугольнике поля подписи (см. SetSignProcessFieldBounds) стандартным шрифтом Helvetica. При FontSize = 0 размер автоматически подгоняется под поле. Изображение, заданное через SetSignProcessFieldImageFromFile, имеет приоритет над текстовым видом, а процессы документных меток времени его игнорируют
Синтаксис
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 LongDLL
int DLSetSignProcessAppearanceText(int InstanceID, int SignProcessID, int Options, const wchar_t * SignerName, double FontSize, double FontRed, double FontGreen, double FontBlue);Параметры
| SignProcessID | Значение, возвращаемое функциями NewSignProcessFromFile, NewSignProcessFromStream или NewSignProcessFromString |
|---|---|
| Options | Битовая маска выбора текстовых строк: 1 = имя подписанта (параметр SignerName), 2 = причина, 4 = место (оба из SetSignProcessInfo), 8 = дата подписания, 16 = описательные метки перед каждой строкой. 0 отключает текстовое представление. |
| SignerName | Имя в строке подписанта при установленном бите 1 |
| FontSize | Размер шрифта в пунктах; 0 автоматически подгоняет текстовый блок под прямоугольник поля подписи |
| FontRed, FontGreen, FontBlue | Составляющие цвета текста в диапазоне 0..1 |
Возвращаемые значения
| 0 | Недопустимый дескриптор процесса подписи |
|---|---|
| 1 | Success |