formContext.getControl (referință API client)

Obține un control în formular.

Notă

getControl funcționează doar în controalele din corpul și antetul formularului. Nu este acceptat pentru controalele din altă parte din pagină, chiar dacă se referă la aceeași coloană.

• Pentru controalele din interiorul fluxurilor de procese de afaceri, consultați-le cu prefixul header_process_.
• Controalele din alte controale, cum ar fi subgrids și controalele cronologie , nu sunt acceptate.

Sintaxă

formContext.getControl(arg);

Metoda formContext.getControl(arg) este o metodă de comandă rapidă pentru a accesa formContext.ui.controls.get.

Parametru

arg: Opțional. Puteți accesa un control dintr-un formular prin trecerea unui argument ca nume sau ca valoare index a controlului dintr-un formular. De exemplu: formContext.getControl("firstname") sau formContext.getControl(0). arg Dacă numele este ortografiat greșit și nu se află în formular, returnează valoarea nulă.

arg Atunci când valoarea nu este furnizată, returnează o matrice a tuturor controalelor din formular.

Valoarea returnată

Tip: Colecție de obiecte, Obiect sau Null.

Descriere: Colecție de obiecte dacă utilizați metoda fără parametri. Obiectul sau valoarea Null dacă utilizați metoda cu un parametru. Dacă utilizați numele ca parametru și există mai multe controale pentru aceeași coloană, se returnează numai primul control.

Bacșiș

Dacă doriți să modificați toate controalele legate la o coloană dintr-un formular, utilizați colecția de controale din interiorul tipului de coloană. De exemplu, pentru a adăuga o notificare la fiecare control legat la name coloană, puteți face următoarele:

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

Articole asociate

formContext