formContext.getControl (klient-API-referens)

Hämtar en kontroll i formuläret.

Anmärkning

getControl fungerar bara på kontroller i formulärets brödtext och sidhuvud. Det stöds inte för kontroller någon annanstans på sidan, även om de refererar till samma kolumn.

• För kontroller i affärsprocessflöden, se dem med prefixet header_process_.
• Kontroller i andra kontroller som underrutnät och tidslinjekontroller stöds inte.

Syntax

formContext.getControl(arg);

Metoden formContext.getControl(arg) är en genvägsmetod för att komma åt formContext.ui.controls.get.

Parameter

arg: Valfritt. Du kan komma åt en kontroll i ett formulär genom att skicka ett argument som antingen namnet eller indexvärdet för kontrollen i ett formulär. Till exempel: formContext.getControl("firstname") eller formContext.getControl(0). Om namnet arg stavas fel och inte finns i formuläret returneras null-värdet.

När värdet arg inte anges returneras en matris med alla kontroller i formuläret.

Returvärde

Typ: Objektsamling, Objekt eller null.

Beskrivning: Objektsamling om du använder metoden utan parametrar. Objekt eller null om du använder metoden med en parameter. Om du använder namnet som en parameter och det finns flera kontroller för samma kolumn returneras bara den första kontrollen.

Tips/Råd

Om du vill ändra alla kontroller som är bundna till en kolumn i ett formulär använder du kontrollsamlingen i kolumntypen. Om du till exempel vill lägga till meddelanden till varje kontroll som är bunden till name kolumnen kan du göra följande:

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

Relaterade artiklar

formContext