Събития във формуляри и мрежи в приложения, управлявани от модел

Събитията инициират целия код от страна на клиента. В приложенията, управлявани от модел, свързвате определена функция в библиотека на JavaScript (скриптов уеб ресурс), която да се изпълнява, когато възникне събитие. Тази функция се нарича манипулатор на събития. Всеки манипулатор на събития задава една функция в библиотека на JavaScript и всички параметри, които могат да бъдат предадени на функцията.

Можете да свържете манипулаторите на събития само с някои събития с помощта на потребителския интерфейс. За събития, които не са налични за свързване чрез потребителски интерфейс, API на клиент предоставя методи, които могат да се използват за прикачване на манипулатори на събития към такива събития.

Добавяне или премахване на функция на манипулатора на събития към събитие с помощта на потребителски интерфейс

Използвайте секцията "Манипулатори на събития " на диалоговия прозорец "Свойства на формуляра ", за да асоциирате скрипта си със събитие за формуляри и колони.

Секцията

Групово редактиране на формуляри

По подразбиране манипулаторите на събития не се извикват, когато формулярът е в режим на групово редактиране.

За да разрешите манипулатор на събития в режим на групово редактиране, променете XML на формуляр, като намерите съответния event елемент и създадете/настроите атрибута Enabledна BehaviorInBulkEditForm . В момента това се поддържа само за събития OnLoad.

За повече информация относно персонализирането на XML формуляр вижте Кога да редактирате файла за персонализации, персонализирането на формуляри и XML схемата на формуляра.

За да определите кога манипулатор на събитие се извиква във формуляр в режим на групово редактиране, използвайте getFormType метод.

Добавяне или премахване на функция на манипулатора на събития към събитие с помощта на код

С помощта на следните методи за добавяне и премахване на манипулатор на събития за събития, които не могат да бъдат свързани чрез потребителския интерфейс:

Събития Манипулатор на събитие
Атрибут OnChange addOnChange и removeOnChange методи
Зареждане на формуляр formContext.ui addOnLoad и removeOnLoad методи
Зареден формуляр formContext.ui addLoaded and removeLoaded methods
Зареждане на данни на формуляр formContext.data addOnLoad и removeOnLoad методи
Записване на формуляр addOnSave и removeOnSave методи
Предварително търсене на справочна контрола addPreSearch и removePreSearch methods
контрола kbsearch OnResultOpened addOnResultOpened и removeOnResultOpened методи
контрола kbsearch OnSelection addOnSelection и removeOnSelection методи
контрола kbsearch PostSearch addOnPostSearch и removeOnPostSearch методи

Важно

Контекстът на изпълнение автоматично се подава като първи параметър на функции, които са зададени с помощта на кода. Повече информация: Контекст за изпълнение на API на клиент

Канал за събитие на формуляр

Можете да дефинирате до 50 манипулатора на събития за всяко събитие. Всеки манипулатор на събития се изпълнява в реда, в който се показва в секцията Манипулатори на събития в раздела Събития на диалоговия прозорец Свойства на формуляра .

Използвайте набораSharedVariable и getSharedVariable , за да предадете обща променлива между манипулаторите на събития (функции). Използвайте метода getDepth на контекста за изпълнение, за да знаете последователността, в която се изпълнява манипулаторът на събития спрямо другите манипулатори на събития.

Разбиране на обектния модел на клиентския API
Контекст за изпълнение на API на клиент
Събития (справка за API на клиент)