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	process id、大括號語法、佔位符名稱、範本長度、佔位符數量或日期格式無效

備註

要輸出字面大括號請用 {{ 與 }}

範本最多可含 32,768 個字元與 256 個佔位出現位置

缺少的自訂變數展開為空文字；內建變數永遠反映目前的簽署程序

之後呼叫 SetSignProcessAppearanceText 會重新選用舊式的逐行外觀

欄位影像仍然優先；文件時間戳程序不渲染文字外觀

另請參閱

SetSignProcessAppearanceVariable, SetSignProcessAppearanceText, SetSignProcessFieldBounds