formContext.getControl (Klient-API-referanse)

Henter en kontroll i skjemaet.

Note

getControl fungerer bare på kontroller i brødteksten og toppteksten i skjemaet. Det støttes ikke for kontroller andre steder på siden, selv om de refererer til den samme kolonnen.

• Hvis du vil ha kontroller i forretningsprosessflyter, kan du se dem med prefikset header_process_.
• Kontroller i andre kontroller som delnett og tidslinjekontroller støttes ikke.

Syntaks

formContext.getControl(arg);

Metoden formContext.getControl(arg) er en hurtigmetode for å få tilgang til formContext.ui.controls.get.

Parameter

arg: Valgfritt. Du kan få tilgang til en kontroll i et skjema ved å sende et argument som enten navnet eller indeksverdien for kontrollen i et skjema. Eksempel: formContext.getControl("firstname") eller formContext.getControl(0). arg Hvis navnet er stavet feil og ikke er i skjemaet, returnerer det nullverdi.

Når verdien ikke er angitt, returnerer den arg en matrise av alle kontrollene i skjemaet.

Returverdi

Type: Objektsamling, objekt eller null.

Beskrivelse: Objektsamling hvis du bruker metoden uten parametere. Objekt eller null hvis du bruker metoden med en parameter. Hvis du bruker navnet som parameter og det finnes flere kontroller for samme kolonne, returneres bare den første kontrollen.

Tips

Hvis du vil endre alle kontrollene som er bundet til en kolonne i et skjema, bruker du kontrollsamlingen i kolonnetypen. Hvis du for eksempel vil legge til varsling i hver kontroll som er bundet til name kolonnen, kan du gjøre følgende:

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

Relaterte artikler

formContext