formContext.getControl (kliento API nuoroda)

Gauna valdiklį į formą.

Pastaba.

getControl veikia tik formos tekste ir antraštėje esantims valdikliams. Valdiklių, esančių kitoje puslapio vietoje, jis nepalaikomas, net jei jie nurodo tą patį stulpelį.

• Valdyme, kurie yra verslo procesų srautų viduje, žr. juos su prefiksu header_process_.
• Kitų valdiklių, pvz., antrinių tinklelių ir laiko planavimo juostos valdiklių, valdikliai nepalaikomi.

Sintaksė

formContext.getControl(arg);

Metodas formContext.getControl(arg) yra spartusis būdas pasiekti formContext.ui.controls.get.

Parametras

arg: pasirinktinai. Formos valdiklį galite pasiekti perduodami argumentą kaip formos valdiklio pavadinimą arba rodyklės reikšmę . Pavyzdžiui: formContext.getControl("firstname") arba formContext.getControl(0). arg Jei pavadinimas parašytas neteisingai ir jo nėra formoje, jis grąžina nulinę reikšmę.

arg Kai reikšmė nepateikiama, ji grąžina visų formos valdiklių masyvą.

Grąžinimo reikšmė

Tipas: objektų rinkinys, objektas arba nulis.

Aprašas: objektų rinkinys, jei metodą naudojate be jokių parametrų. Objektas arba nulis, jei metodą naudojate su parametru. Jei pavadinimą naudojate kaip parametrą ir tame pačiame stulpelyje yra keli valdikliai, grąžinamas tik pirmasis valdiklis.

Arbatpinigiai

Jei norite modifikuoti visus valdiklius, susietų su formos stulpeliu, naudokite valdiklių rinkinį, esantį stulpelio tipe. Pavyzdžiui, norėdami įtraukti pranešimą į kiekvieną valdiklį, susietą su name stulpeliu, galite atlikti šiuos veiksmus:

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

Susiję straipsniai

formContext