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 |
| ActionKind | Одна из констант PDF_ACTION_BUILDER_*, поддерживаемых AddActionNextEx |
| Value | URI, именованное действие, исходный код JavaScript, имя файла импорта данных или неиспользуемое значение для действий назначения |
| FieldNames | Разделённый запятыми список полей для действий скрытия, отправки и сброса |
| Flags | Специфичные для действия флаги или индекс ветки с базой 1 для PDF_ACTION_BUILDER_THREAD |
| DestID | Дескриптор назначения для PDF_ACTION_BUILDER_DESTINATION либо индекс bead с базой 1 для PDF_ACTION_BUILDER_THREAD, где 0 выбирает первый bead |
Возвращаемые значения
| 0 | Поле, имя события, вид действия или требуемое значение были недопустимы, либо активен режим PDF/X-6 |
|---|---|
| 1 | Действие построено и назначено выбранному событию поля |
Замечания
Этот помощник объединяет разрешение имени события с построением действия, что избавляет от отдельных временных дескрипторов действий, когда событию поля нужно лишь прямое действие URI, JavaScript, скрытия, отправки, сброса, импорта данных, именованное, назначения или ветки статьи Дополнительные действия полей формы отклоняются, пока активен режим PDF/A или PDF/X-6, поскольку оба профиля запрещают словари
/AA полей и виджетов, даже когда выбранный тип действия в остальных случаях разрешён