SetSignProcessAppearanceText

セキュリティと署名

説明

指定したデジタル署名プロセスの署名フィールドに、自動生成された可視テキストアピアランスを構築します。Options ビットマスクで表示する行を選択します。署名者名、SetSignProcessInfo で指定した理由と場所、署名日を選択でき、オプションで "Signed by:" や "Reason:" などの説明ラベルを付けられます

テキストブロックは標準 Helvetica フォントを使用して署名フィールド矩形内に配置されます(SetSignProcessFieldBounds を参照)。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 Long

DLL

int DLSetSignProcessAppearanceText(int InstanceID, int SignProcessID, int Options, const wchar_t * SignerName, double FontSize, double FontRed, double FontGreen, double FontBlue);

パラメータ

SignProcessIDNewSignProcessFromFile、NewSignProcessFromStream、または NewSignProcessFromString 関数が返す値
Optionsテキスト行を選択するビットマスク: 1 = 署名者名(SignerName パラメータ)、2 = 理由、4 = 場所(どちらも SetSignProcessInfo から取得)、8 = 署名日、16 = 各行の前に表示する説明ラベル。0 でテキスト外観を無効にします
SignerNameビット 1 が設定されている場合に署名者名の行へ表示される名前
FontSizeポイント単位のフォントサイズ。0 の場合、テキストブロックを署名フィールド矩形に自動的に合わせます
FontRed, FontGreen, FontBlue0..1 の範囲のテキスト色成分

戻り値

0署名処理ハンドルが無効です
1Success