THotPDF Form Field Action Convenience Methods
为在 AcroForm 字段和控件附加动作触发器上安装或清除 THPDFActionBuilder 动作链提供命名包装
Declarations
procedure ClearFormFieldAdditionalAction(const FieldName: AnsiString; Trigger: THPDFFormFieldActionTrigger);
procedure SetFormFieldKeyStrokeAction(const FieldName: AnsiString; Action: THPDFActionBuilder);
procedure ClearFormFieldKeyStrokeAction(const FieldName: AnsiString);
procedure SetFormFieldFormatAction(const FieldName: AnsiString; Action: THPDFActionBuilder);
procedure ClearFormFieldFormatAction(const FieldName: AnsiString);
procedure SetFormFieldValidateAction(const FieldName: AnsiString; Action: THPDFActionBuilder);
procedure ClearFormFieldValidateAction(const FieldName: AnsiString);
procedure SetFormFieldCalculateAction(const FieldName: AnsiString; Action: THPDFActionBuilder);
procedure ClearFormFieldCalculateAction(const FieldName: AnsiString);
procedure SetFormFieldAnnotationAction(const FieldName: AnsiString; Trigger: THPDFAnnotationActionTrigger; Action: THPDFActionBuilder);
procedure ClearFormFieldAnnotationAction(const FieldName: AnsiString; Trigger: THPDFAnnotationActionTrigger);
procedure SetFormFieldMouseEnterAction(const FieldName: AnsiString; Action: THPDFActionBuilder);
procedure ClearFormFieldMouseEnterAction(const FieldName: AnsiString);
procedure SetFormFieldMouseExitAction(const FieldName: AnsiString; Action: THPDFActionBuilder);
procedure ClearFormFieldMouseExitAction(const FieldName: AnsiString);
procedure SetFormFieldMouseDownAction(const FieldName: AnsiString; Action: THPDFActionBuilder);
procedure ClearFormFieldMouseDownAction(const FieldName: AnsiString);
procedure SetFormFieldMouseUpAction(const FieldName: AnsiString; Action: THPDFActionBuilder);
procedure ClearFormFieldMouseUpAction(const FieldName: AnsiString);
procedure SetFormFieldSetFocusAction(const FieldName: AnsiString; Action: THPDFActionBuilder);
procedure ClearFormFieldSetFocusAction(const FieldName: AnsiString);
procedure SetFormFieldLostFocusAction(const FieldName: AnsiString; Action: THPDFActionBuilder);
procedure ClearFormFieldLostFocusAction(const FieldName: AnsiString);单元
HPDFDoc
Trigger map
| Method family | PDF trigger | Purpose |
|---|---|---|
SetFormFieldKeyStrokeAction / ClearFormFieldKeyStrokeAction | /AA /K | 文本值更改前处理击键 |
SetFormFieldFormatAction / ClearFormFieldFormatAction | /AA /F | 字段值更改后进行格式化 |
SetFormFieldValidateAction / ClearFormFieldValidateAction | /AA /V | 值提交前进行验证 |
SetFormFieldCalculateAction / ClearFormFieldCalculateAction | /AA /C | 依赖字段更改后进行计算 |
SetFormFieldMouseEnterAction / ClearFormFieldMouseEnterAction | /AA /E | 指针进入控件区域 |
SetFormFieldMouseExitAction / ClearFormFieldMouseExitAction | /AA /X | 指针移出控件区域 |
SetFormFieldMouseDownAction / ClearFormFieldMouseDownAction | /AA /D | 在控件内按下鼠标键 |
SetFormFieldMouseUpAction / ClearFormFieldMouseUpAction | /AA /U | 在控件内释放鼠标键 |
SetFormFieldSetFocusAction / ClearFormFieldSetFocusAction | /AA /Fo | 控件获得输入焦点 |
SetFormFieldLostFocusAction / ClearFormFieldLostFocusAction | /AA /Bl | 控件失去输入焦点 |
使用说明
- 在创建目标字段之后、
EndDoc之前调用这些 set 辅助方法 - 每个 set 辅助方法只替换匹配的触发器条目，字段或控件
/AA字典的其余部分保持不变 - 每个 clear 辅助方法只移除匹配的触发器条目，并在没有剩余条目时删除空的
/AA字典 - 当代码已经直接处理
THPDFFormFieldActionTrigger时，使用SetFormFieldAdditionalAction和ClearFormFieldAdditionalAction - 当代码已经直接处理
THPDFAnnotationActionTrigger时，使用SetFormFieldAnnotationAction和ClearFormFieldAnnotationAction - Builder validation still enforces PDF/A and PDF/X action restrictions before action dictionaries are written