SetFormFieldActionEx
表单域、注释和热点链接
描述
使用事件名称和命名操作构建器常量构建并指派表单字段触发器操作
语法
Delphi
Function TPDFlib.SetFormFieldActionEx(Index: Integer; Const EventName: WideString; ActionKind: Integer; Const Value, FieldNames: WideString; Flags, DestID: Integer): Integer;
参数
| Index | 从 1 开始的表单字段索引 |
|---|---|
| EventName | 触发事件名称,例如 MouseUp、MouseDown、MouseEnter、MouseExit、Focus、LostFocus、KeyPress、BeforeFormatting、Change 或 Calculate |
| ActionKind | PDF_ACTION_BUILDER_* 支持的 AddActionNextEx 常量之一 |
| Value | URI、命名操作、JavaScript 源代码、导入数据文件名,或目标操作未使用的值 |
| FieldNames | hide、submit 和 reset 操作使用的逗号分隔字段列表 |
| Flags | 操作特定标志,或 PDF_ACTION_BUILDER_THREAD 的从 1 开始的文章线索索引 |
| DestID | PDF_ACTION_BUILDER_DESTINATION 的目标句柄,或 PDF_ACTION_BUILDER_THREAD 的从 1 开始的珠索引(0 选择第一个珠) |
返回值
| 0 | 字段、事件名称、操作种类或所需值无效,或 PDF/X-6 模式处于激活状态 |
|---|---|
| 1 | 操作已构建并指派给所选字段事件 |
说明
此辅助函数把事件名称解析与操作构建结合在一起,当字段事件只需要直接的 URI、JavaScript、hide、submit、reset、import-data、named、destination 或文章 Thread 操作时,可避免单独的临时操作句柄 PDF/A 或 PDF/X-6 模式激活期间会拒绝表单字段附加操作,因为两种配置都禁止字段和 Widget 的
/AA 字典,即使所选操作类型在其他情况下是被允许的