formContext.getControl (препратка към API на клиент)

Получава контрола във формуляра.

Бележка

getControl работи само върху контроли в основния текст и горния колонтитул на формуляра. То не се поддържа за контроли на друго място на страницата дори ако те препращат към същата колона.

• За контролите в потоците на бизнес процесите се обърнете към тях с префикса header_process_.
• Контролите в други контроли, като например подмрежи и контроли на времева линия , не се поддържат.

Синтаксис

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