THotPDF 表單欄位動作便利方法

方法摘要: THotPDF 表單欄位動作便利方法THPDFActionBuilder chains on AcroForm field and widget additional-action triggers

宣告

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

觸發時機對應

方法家族	PDF 觸發時機	用途
`SetFormFieldKeyStrokeAction` / `ClearFormFieldKeyStrokeAction`	/AA /K文字值變更前的按鍵處理`ClearFormFieldFormatAction`	/AA /F欄位值變更後的格式化
`SetFormFieldValidateAction` / `ClearFormFieldValidateAction`	/AA /V值送出前的驗證`ClearFormFieldCalculateAction`	/AA /C相依欄位變更後的計算
`SetFormFieldMouseEnterAction` / `ClearFormFieldMouseEnterAction`	/AA /E游標進入標註區域`ClearFormFieldMouseExitAction`	/AA /X游標離開標註區域
`SetFormFieldMouseDownAction` / `ClearFormFieldMouseDownAction`	/AA /D在 widget 內按下滑鼠按鍵`ClearFormFieldMouseUpAction`	/AA /U在 widget 內放開滑鼠按鍵
`SetFormFieldSetFocusAction` / `ClearFormFieldSetFocusAction`	/AA /Fowidget 取得輸入焦點`/AA /E`	Widget pointer enters the annotation area
`SetFormFieldLostFocusAction` / `ClearFormFieldMouseExitAction`	`/AA /X`	Widget pointer exits the annotation area
`SetFormFieldMouseDownAction` / `ClearFormFieldMouseDownAction`	`/AA /D`	Mouse button is pressed inside the widget
`SetFormFieldMouseUpAction` / `ClearFormFieldMouseUpAction`	`/AA /U`	Mouse button is released inside the widget
`SetFormFieldSetFocusAction` / `ClearFormFieldSetFocusAction`	`/AA /Fo`	Widget receives input focus
`SetFormFieldLostFocusAction` / `ClearFormFieldLostFocusAction`	`ClearFormFieldLostFocusAction`	/AA /Blwidget 失去輸入焦點

使用說明

先建立目標欄位，並在 EndDoc 之前呼叫這些 set 輔助方法EndDoc
每個 set 輔助方法只替換對應的觸發時機項目，欄位或 widget /AA 字典的其餘內容保持不動/AA dictionary intact
每個 clear 輔助方法只移除對應的觸發時機項目；沒有剩餘項目時會一併刪除空的 /AA 字典/AA dictionary when no entries remain
程式碼已改用 THPDFFormFieldActionTrigger 時，請改用 SetFormFieldAdditionalAction 與 ClearFormFieldAdditionalActionSetFormFieldAdditionalAction and ClearFormFieldAdditionalAction when code already works with THPDFFormFieldActionTrigger
程式碼已改用 THPDFAnnotationActionTrigger 時，請改用 SetFormFieldAnnotationAction 與 ClearFormFieldAnnotationActionSetFormFieldAnnotationAction and ClearFormFieldAnnotationAction when code already works with THPDFAnnotationActionTrigger
寫入動作字典之前，builder 驗證仍會強制套用 PDF/A 與 PDF/X 的動作限制

THotPDF 表單欄位動作便利方法

宣告

單元

觸發時機對應

使用說明

相關 API