TXFAEventAction

單元：HPDFXFAEventScript

宣告

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

行為

代表一般事件宿主發出的已解析字面操作或已驗證變更

Kind 選擇 presence、raw 值、存取或 instance 操作；參數攜帶索引與 instance 設定

一般宿主把 Target 用作綁定參照，把 VirtualPath 用作同一事件期間建立節點的已驗證位置

Action 值使用 UTF-8 文字；無效的 Unicode、action 欄位或預算會在文件發布前拒絕該事件

請用 TXFAWidgetRuntime.DispatchEvent 做已驗證的重播與 rollback，不要把記錄直接套到共用的文件上

身分綁定與 script 結果以 Value 攜帶其已驗證文字，由 runtime 解讀，而非當作一般表單變更

宿主狀態動作在 Value 中攜帶 name|value 文字；焦點動作攜帶 focus 或 clear，重設編輯動作的 Value 為空並帶選定欄位目標

PropertyPath 定址 Target 所選表單擁有者底下的屬性，使用 font[0]/fill[0]/color[0] 這類 class occurrence；擁有者是在目前事件期間插入時，可與 VirtualPath 併用

空的 PropertyPath 保留既有直接綁定目標；套用建立或後續寫入之前，runtime 會驗證路徑深度、schema 基數、選擇群組與原生節點預算

DataPath 識別 Target 所選資料綁定底下、由 XML 匯入建立的新 Data DOM 後代，使用零基的元素子位置（如 0/1）；文字、註解與 processing instructions 不計入元素位置

擁有它的 data group 是由表單 instance 管理器在目前事件期間建立時，DataPath 可與 VirtualPath 併用

xeakLoadDataXML 在 Value 中攜帶輸入的 UTF-8 XML，Argument 選擇 ignoreRoot，Argument2 選擇 overwrite；原生 runtime 會先解析來源，再變更選定的目標

runtime 會對實際匯入的原生圖解析新的後代寫入與身分發布，然後套用與一般欄位變更相同的事件交易與 rollback

相關 API

互動式動態 XFA Widget Runtime、FormCalc 函式與XFA Packet DOM