ExecuteFormFieldScript
Формы, безопасность JavaScript
Описание
Выполняет выбранное действие поля через ограниченную среду событий, используя оболочку совместимости только со значением Поддерживаемое подмножество включает вспомогательные действия форм, создаваемые API форматирования, проверки диапазона и простых вычислений, а также присваивания
event.value и event.rc с использованием арифметики, сравнений, логических операторов, условных конструкций, контролируемых свойств Event, Field и Document, числовых преобразований и распространенных функций Math
Синтаксис
Function TPDFlib.ExecuteFormFieldScript(Index: Integer; Action: TPDFlibFormScriptAction; Const InputValue: WideString; Out OutputValue: WideString): Integer;
Параметры
| Index | Индекс поля формы, начиная с 1 |
|---|---|
| Action | Выполняемое действие валидации, вычисления, форматирования или нажатия клавиши |
| InputValue | Начальное значение, предоставляемое как event.value |
| OutputValue | Итоговое значение после успешного выполнения |
Возвращаемые значения
Возвращает 1, когда действие выполняется и принимает значение, или 0, когда действие отсутствует, отклоняет событие, не поддерживается, недопустимо или превышает настроенный лимит ресурсов
Отклоненная валидация оставляет
LastErrorCode нулевым; неподдерживаемые, недопустимые и превысившие бюджет скрипты сообщают коды 706, 708 и 709
Примечания
Успешное действие вычисления записывает свой результат в поле, тогда как валидация и форматирование возвращают результат, не меняя сохраненное значение поля Неподдерживаемые инструкции, такие как
app.alert, динамический код, глобальный доступ и внешний ввод-вывод, никогда не вызываются
Используйте
ExecuteFormFieldScriptEvent, когда требуются изменения нажатий клавиш, состояние выделения, модификаторы клавиш, состояние фиксации или свойства исходного и целевого полей
См. также
ExecuteFormFieldScriptEvent, SetFormScriptLimits, GetFormScriptDiagnostics, RecalculateFormFields, GetFormCalculationGraphJSON, TPDFlibFormScriptAction