SetSignProcessAppearanceTemplate

安全和签名

描述

为数字签名过程配置可见文本外观模板

生成签名时模板只会展开一次，因此相同版式可复用于不同的签名元数据和应用程序值

语法

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	包含任意内置占位符 `{signer}`、`{reason}`、`{location}`、`{contact}`、`{date}`、`{field}` 和 `{page}` 的文本和换行，以及通过 SetSignProcessAppearanceVariable 注册的自定义名称
SignerName	替换 `{signer}` 的值
DateFormat	`{date}` 使用的 Delphi 日期和时间格式；若为 `yyyy-mm-dd hh:nn:ss`，则使用空字符串
FontSize	以点为单位的字体大小，或使用 `0` 自动适配文本块
FontRed, FontGreen, FontBlue	范围为 `0..1` 的文本颜色分量

返回值

1	模板已接受
0	进程 ID、大括号语法、占位符名称、模板长度、占位符数量或日期格式无效

备注

使用 {{ 和 }} 输出花括号字面量

模板最多可包含 32,768 个字符和 256 个占位符出现位置

缺少的自定义变量扩展为空文本，而内置变量始终反映当前签名流程

稍后调用 SetSignProcessAppearanceText 会再次选择旧式基于行的外观

字段图像仍具有优先级，文档时间戳进程不会渲染文本外观

另请参阅

SetSignProcessAppearanceVariable, SetSignProcessAppearanceText, SetSignProcessFieldBounds