TXFAEventAction

单元：HPDFXFAEventScript

声明

TXFAEventAction= record
  Kind: TXFAEventActionKind;
  Target, Presence, Value: AnsiString;
  Argument, Argument2: Integer;
  VirtualPath: AnsiString;
  PropertyPath: AnsiString;
  DataPath: AnsiString;
end;

行为

表示通用事件宿主产出的已解析字面操作或已验证变更

Kind 选择 presence、raw value、access 或实例操作；参数携带下标与实例设置

通用宿主把 Target 用作绑定引用，把 VirtualPath 用作同一事件中创建节点的已验证位置

action 值使用 UTF-8 文本；非法 Unicode、action 字段或预算会在文档发布前拒绝该事件

经验证的重放与回滚请用 TXFAWidgetRuntime.DispatchEvent，不要把记录直接套到共享文档上

身份绑定与脚本结果用 Value 承载已验证文本，由运行时解释，而不是当作普通表单变更

宿主状态 action 在 Value 中携带 name|value 文本；focus action 携带 focus 或 clear，重置编辑 action 的 Value 为空并带选定字段目标

PropertyPath 寻址 Target 所选表单所有者之下的属性，使用 font[0]/fill[0]/color[0] 这类 class 实例；所有者是在当前事件中插入时，可与 VirtualPath 组合

空 PropertyPath 保留既有的直接绑定目标；运行时在应用创建或后续写入之前校验路径深度、schema 基数、choice 组与原生节点预算

DataPath 标识由 XML 导入在 Target 所选数据绑定之下新建的 Data DOM 后代，使用从零计数的元素子节点位置（如 0/1）；文本、注释与处理指令不计入元素位置

所属数据组是在当前事件中由表单实例管理器创建时，DataPath 可与 VirtualPath 同用

xeakLoadDataXML 在 Value 中携带传入的 UTF-8 XML，Argument 选择 ignoreRoot，Argument2 选择 overwrite；原生运行时在改动选定目标之前先解析源

运行时针对真实导入的原生对象图解析新后代写入与身份发布，然后应用与普通字段变更相同的事件事务与回滚

相关 API

交互式动态 XFA 控件运行时, FormCalc 函数和 XFA Packet DOM