THotPDF.SetFormFieldAdditionalAction Method
THPDFActionBuilder からの AcroForm フィールド追加アクションを、フィールドウィジェットの /AA 辞書の下に設定します
宣言
procedure SetFormFieldAdditionalAction(const FieldName: AnsiString; Trigger: THPDFFormFieldActionTrigger; Action: THPDFActionBuilder);
ユニット
HPDFDoc
パラメータ
| 名前 | 目的 |
|---|---|
FieldName | 生成されたフィールドリストから探す、既存の AcroForm フィールド名 |
Trigger | フィールド追加アクションのトリガー。KeyStroke・Format・Validate・Calculate のいずれか |
Action | THPDFActionBuilder で構築されたアクションチェーン |
使用上の注意
- 対象フィールドを作成した後、
EndDocの前にこのメソッドを呼び出してください - このメソッドは同じトリガーキーの既存アクションを置き換え、他の
/AAエントリは変更しません - 他のフィールドアクションに触れずに 1 つのフィールドトリガーエントリを削除するには
ClearFormFieldAdditionalActionを使用します - フィールドやウィジェットのトリガーごとに 1 つのメソッドを呼ぶコードでは、
THotPDFFormFieldActionConvenienceMethodsの名前付きヘルパーを使用してください - ビルダーの検証は、それらの適合ファミリーで許可されないアクションタイプに対して PDF/A と PDF/X の制限を強制します
- JavaScript 専用の簡易経路には、
AttachFieldKeyStrokeAction・AttachFieldFormatAction・AttachFieldValidateAction・AttachFieldCalculateActionのいずれかを使用します
Related API
- THPDFActionBuilderClass
- AcroFormSupport
- THotPDFFormFieldActionConvenienceMethods
- THotPDFAttachFieldKeyStrokeActionMethod