THotPDF Form Field Action Convenience Methods

Дают именованные обёртки для установки или очистки THPDFActionBuilder цепочек на триггерах additional-action полей AcroForm и widget

Declarations

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

Trigger map

Семейство методов	Триггер PDF	Назначение
`SetFormFieldKeyStrokeAction` / `ClearFormFieldKeyStrokeAction`	`/AA /K`	Обработка нажатий до изменения текстового значения
`SetFormFieldFormatAction` / `ClearFormFieldFormatAction`	`/AA /F`	Форматирование после изменения значения поля
`SetFormFieldValidateAction` / `ClearFormFieldValidateAction`	`/AA /V`	Валидация до фиксации значения
`SetFormFieldCalculateAction` / `ClearFormFieldCalculateAction`	`/AA /C`	Вычисление после изменения зависимых полей
`SetFormFieldMouseEnterAction` / `ClearFormFieldMouseEnterAction`	`/AA /E`	Указатель входит в область аннотации widget
`SetFormFieldMouseExitAction` / `ClearFormFieldMouseExitAction`	`/AA /X`	Указатель покидает область аннотации widget
`SetFormFieldMouseDownAction` / `ClearFormFieldMouseDownAction`	`/AA /D`	Кнопка мыши нажата внутри widget
`SetFormFieldMouseUpAction` / `ClearFormFieldMouseUpAction`	`/AA /U`	Кнопка мыши отпущена внутри widget
`SetFormFieldSetFocusAction` / `ClearFormFieldSetFocusAction`	`/AA /Fo`	Widget получает фокус ввода
`SetFormFieldLostFocusAction` / `ClearFormFieldLostFocusAction`	`/AA /Bl`	Widget теряет фокус ввода

Примечания по использованию

Вызывайте set-хелперы после создания целевого поля и до EndDoc
Каждый set-хелпер замещает только совпадающую запись триггера и сохраняет остальной словарь /AA поля или widget нетронутым
Каждый clear-хелпер удаляет только совпадающую запись триггера и стирает пустой /AA словарь, когда записей не остаётся
Используйте SetFormFieldAdditionalAction и ClearFormFieldAdditionalAction когда код уже работает с THPDFFormFieldActionTrigger
Используйте SetFormFieldAnnotationAction и ClearFormFieldAnnotationAction когда код уже работает с THPDFAnnotationActionTrigger
Валидация builder по-прежнему обеспечивает ограничения action PDF/A и PDF/X до записи словарей action

Related API

THotPDFSetFormFieldAdditionalActionMethod
THPDFPageSetAnnotationAdditionalActionMethod
THPDFPageClearAnnotationAdditionalActionMethod
THPDFActionBuilderClass
AcroFormSupport