formContext.getControl (odkaz na klientske rozhranie API)

Načíta ovládací prvok vo formulári.

Note

getControl Funguje len s ovládacími prvkami v tele a hlavičke formulára. Nie je podporovaný pre ovládacie prvky inde na stránke, dokonca ani vtedy, ak odkazujú na rovnaký stĺpec.

• Ovládacie prvky v postupoch obchodných procesov nájdete na nich s predponou header_process_.
• Ovládacie prvky v rámci iných ovládacích prvkov, ako sú napríklad vedľajšie mriežky a ovládacie prvky časovej osi , nie sú podporované.

Syntax

formContext.getControl(arg);

Metóda formContext.getControl(arg) je metóda odkazu na prístup k ovládacím prvkom formContext.ui.get.

Parameter

arg: Voliteľné. K ovládaciemu prvku vo formulári môžete získať prístup odovzdaním argumentu buď ako názov , alebo hodnota indexu ovládacieho prvku vo formulári. Napríklad: formContext.getControl("firstname") alebo formContext.getControl(0). arg Ak je názov napísané nesprávne a nie je vo formulári, vráti hodnotu null.

arg Ak hodnota nie je zadaná, vráti pole všetkých ovládacích prvkov vo formulári.

Vrátená hodnota

Typ: Kolekcia objektov, Objekt alebo hodnota null.

Popis: Kolekcia objektov, ak používate metódu bez parametrov. Objekt alebo hodnota null, ak použijete metódu s parametrom. Ak použijete názov ako parameter a pre rovnaký stĺpec existuje viacero ovládacích prvkov, vráti sa iba prvý ovládací prvok.

Prepitné

Ak chcete upraviť všetky ovládacie prvky naviazané na stĺpec vo formulári, použite kolekciu ovládacích prvkov v rámci typu stĺpca. Ak chcete napríklad pridať oznámenie každému ovládaciemu prvku name , ktorý je naviazaný na stĺpec, môžete postupovať takto:

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

Súvisiace články

formContext