formContext.getControl (asiakkaan ohjelmointirajapinnan viittaus)

Hakee ohjausobjektin lomakkeesta.

Note

getControl toimii vain lomakkeiden leipätekstin ja ylätunnisteen ohjausobjekteissa. Sitä ei tueta sivun muissa ohjausobjekteissa, vaikka ne viittaavat samaan sarakkeeseen.

• Katso liiketoimintaprosessien työnkulkujen ohjausobjekteja niiden etuliitteellä header_process_.
• Muiden ohjausobjektien, kuten aliruudukoiden ja aikajanan ohjausobjektien, sisältämiä ohjausobjekteja ei tueta.

Syntaksi

formContext.getControl(arg);

formContext.getControl(arg)-menetelmä on pikakuvakemenetelmä formContext.ui.controls.get-kohteen käyttämiseen.

Parametri

arg: Valinnainen. Voit käyttää ohjausobjektia lomakkeessa välittämällä argumentin joko ohjausobjektin nimenä tai indeksiarvona lomakkeessa. Esimerkiksi: formContext.getControl("firstname") tai formContext.getControl(0). arg Jos nimi on kirjoitettu väärin eikä se ole lomakkeessa, se palauttaa tyhjäarvon.

arg Kun arvoa ei anneta, se palauttaa matriisin kaikista lomakkeen ohjausobjekteista.

Palautusarvo

Tyyppi: Objektikokoelma, objekti tai tyhjäarvo.

Kuvaus: Objektikokoelma, jos käytät -menetelmää ilman parametreja. Objekti tai tyhjäarvo, jos käytät -menetelmää parametrin kanssa. Jos käytät nimeä parametrina ja samassa sarakkeessa on useita ohjausobjekteja, vain ensimmäinen ohjausobjekti palautetaan.

Vinkki

Jos haluat muokata kaikkia lomakkeen sarakkeeseen sidottuja ohjausobjekteja, käytä saraketyypin sisällä olevaa ohjausobjektikokoelmaa. Jos haluat esimerkiksi lisätä ilmoituksen jokaiseen sarakkeeseen sidottuun ohjausobjektiin name , voit tehdä seuraavaa:

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

Liittyvät artikkelit

formContext