Поделиться через


formContext.getControl (справочник по API клиента)

Получает элемент управления в форме.

Замечание

getControl работает только над элементами управления в тексте формы и заголовке. Он не поддерживается для элементов управления в другом месте страницы, даже если они ссылаются на тот же столбец.

Синтаксис

formContext.getControl(arg);

Метод formContext.getControl(arg) — это ярлык метода для доступа к formContext.ui.controls.get.

Параметр

arg: необязательный. Вы можете получить доступ к элементу управления в форме, передав аргумент как имя или значение индекса элемента управления в форме. Пример: formContext.getControl("firstname") или formContext.getControl(0). arg Если имя орфографировано неправильно и не находится в форме, возвращает значение NULL.

arg Если значение не указано, он возвращает массив всех элементов управления в форме.

Возвращаемое значение

Тип: коллекция объектов, объект или null.

Описание: коллекция объектов, если используется метод без параметров. Объект или null, если используется метод с параметром. Если вы используете имя в качестве параметра и имеете несколько элементов управления для одного столбца, возвращается только первый элемент управления.

Подсказка

Если вы хотите изменить все элементы управления, привязанные к столбцу в форме, используйте коллекцию элементов управления внутри типа столбца. Например, чтобы добавить уведомление в каждый элемент управления, привязанный к столбцу name , можно выполнить следующее:

 const notification = {
 messages: ['Sample Notification on Name Controls'],
 notificationLevel: 'RECOMMENDATION',
 uniqueId: 'my_unique_id'};
formContext.getAttribute("name").controls.forEach(control => control.addNotification(notification));

formContext