formContext.getControl (referenca klijentskog API-ja)

Dohvaća kontrolu na obrascu.

Napomena

getControl funkcionira samo na kontrolama u tijelu i zaglavlju obrasca. Nije podržan za kontrole na nekom drugom mjestu na stranici, čak i ako se odnose na isti stupac.

• Kontrole unutar tijekova poslovnih procesa potražite u prefiksu header_process_.
• Kontrole unutar drugih kontrola kao što su podrešetke ikontrole vremenske crte nisu podržane.

Sintaksa

formContext.getControl(arg);

Metoda formContext.getControl(arg) metoda je prečaca za pristup formContext.ui.controls.get.

Parametar

Arg: neobavezno. Kontroli na obrascu možete pristupiti tako da argument dodate kao naziv ili kao vrijednost indeksa kontrole na obrascu. Na primjer: formContext.getControl("firstname") ili formContext.getControl(0). Ako je arg naziv pogrešno napisan i nije u obrascu, vraća vrijednost null.

arg Kada vrijednost nije navedena, vraća polje svih kontrola na obrascu.

Povratna vrijednost

Vrsta: zbirka objekata, objekt ili null.

Opis: zbirka objekata ako koristite metodu bez parametara. Objekt ili null ako koristite metodu s parametrom. Ako naziv koristite kao parametar, a postoji više kontrola za isti stupac, tada se vraća samo prva kontrola.

Savjet

Ako želite izmijeniti sve kontrole povezane sa stupcem na obrascu, koristite zbirku kontrola unutar vrste stupaca. Da biste, primjerice, dodali obavijest svakoj kontroli povezanoj name sa stupcem, učinite sljedeće:

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

Povezani članci

oblikKontekst