formContext.getControl (Klienta API atsauce)

Iegūst veidlapas vadīklu.

Piezīmes

getControl Darbojas tikai ar veidlapas pamatteksta un galvenes vadīklām. Tas netiek atbalstīts vadīklām citur lapā, pat ja tās attiecas uz vienu un to pašu kolonnu.

• Vadīklas biznesa procesa plūsmās skatiet tās ar prefiksu header_process_.
• Vadīklas citās vadīklās, piemēram , apakšrežģos un laika grafika vadīklās , netiek atbalstītas.

Sintakse

formContext.getControl(arg);

Metode formContext.getControl(arg) ir saīsnes metode, lai piekļūtu formContext.ui.controls.get.

Parametrs

arg: Pēc izvēles. Veidlapas vadīklai var piekļūt, nododot argumentu kā veidlapas vadīklas nosaukumu vai indeksa vērtību . Piemēram: formContext.getControl("firstname") vai formContext.getControl(0). Ja arg nosaukums ir uzrakstīts nepareizi un veidlapā nav norādīts, tiek atgriezta vērtība Null.

Ja arg vērtība nav norādīta, tiek atgriezts visu veidlapas vadīklu masīvs.

Atgrieztā vērtība

Tips: Objektu kolekcija, Objekts vai Null.

Apraksts: Objektu kolekcija, ja izmantojat metodi bez parametriem. Objekts vai nulle, ja izmantojat metodi ar parametru. Ja nosaukumu izmantojat kā parametru un vienai kolonnai ir vairākas vadīklas, tiek atgriezta tikai pirmā vadīkla.

Padoms

Ja vēlaties modificēt visas vadīklas, kas saistītas ar veidlapas kolonnu, izmantojiet vadīklu kolekciju kolonnas tipā. Piemēram, lai pievienotu paziņojumu katrai kolonnai saistītajai name vadīklai, varat rīkoties šādi:

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

Saistītie raksti

formKonteksts