SetSignProcessAppearanceTemplate
セキュリティと署名
説明
デジタル署名プロセス用の可視テキスト外観テンプレートを構成します
テンプレートは署名の生成時に 1 回展開されるため、同じレイアウトを異なる署名メタデータやアプリケーション値で再利用できます
構文
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