SetSignProcessAppearanceTemplate

Безопасность и подписи

Описание

Настраивает видимый шаблон текстового appearance для процесса цифровой подписи

Шаблон разворачивается один раз при создании подписи, поэтому одну компоновку можно переиспользовать с разными метаданными подписания и значениями приложения

Синтаксис

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

Параметры

SignProcessID	Значение, возвращенное функцией `NewSignProcessFrom*`
TemplateText	Текст и разрывы строк, содержащие любой из встроенных placeholders `{signer}`, `{reason}`, `{location}`, `{contact}`, `{date}`, `{field}` и `{page}`, а также пользовательские имена, зарегистрированные через SetSignProcessAppearanceVariable
SignerName	Значение, подставляемое вместо `{signer}`
DateFormat	Формат даты и времени Delphi, используемый `{date}`, или пустая строка для `yyyy-mm-dd hh:nn:ss`
FontSize	Размер шрифта в пунктах или `0` для автоматического вписывания текстового блока
FontRed, FontGreen, FontBlue	Компоненты цвета текста в диапазоне `0..1`

Возвращаемые значения

1	Шаблон принят
0	Недопустимы ID процесса, синтаксис фигурных скобок, имя плейсхолдера, длина шаблона, число плейсхолдеров или формат даты

Примечания

Используйте {{ и }}, чтобы вывести литеральные фигурные скобки

Шаблон может содержать до 32 768 символов и 256 вхождений placeholder

Изображение поля все же имеет приоритет, а процессы метки времени документа не рендерят текстовый вид

Последующий вызов SetSignProcessAppearanceText снова выбирает устаревший appearance на основе строк

Изображение поля по-прежнему имеет приоритет, а процессы отметки времени документа не отрисовывают текстовый appearance

См. также

SetSignProcessAppearanceVariable, SetSignProcessAppearanceText, SetSignProcessFieldBounds