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
ActionKindPDF_ACTION_BUILDER_* 常數之一,由 AddActionNextEx 支援
ValueURI、具名動作、JavaScript 原始碼、匯入資料檔案名稱,或目的地動作未使用的值
FieldNames隱藏、提交與重設動作使用的逗號分隔欄位清單
Flags動作專屬旗標,或 PDF_ACTION_BUILDER_THREAD 的以 1 為起始執行緒索引
DestIDPDF_ACTION_BUILDER_DESTINATION 的目的地控制代碼,或 PDF_ACTION_BUILDER_THREAD 的以 1 為起始 bead 索引(0 表示第一個 bead)

傳回值

0欄位、事件名稱、動作類型或必要值無效,或 PDF/X-6 模式作用中
1動作已建構並指派給所選的欄位事件

備註

此輔助方法將事件名稱解析與動作建構合而為一,當欄位事件只需要直接的 URI、JavaScript、隱藏、提交、重設、匯入資料、具名、目的地或文章 Thread 動作時,可避免使用個別的暫時動作控制代碼 在 PDF/A 或 PDF/X-6 模式作用中時,表單欄位額外動作會遭到拒絕,因為這兩種設定檔都禁止欄位與 Widget 的

/AA 字典,即使所選的動作類型在其他情況下是被允許的