formContext.getControl (referència de l'API del client)

Obté un control sobre el formulari.

Nota

getControl només funciona en controls del cos del formulari i la capçalera. No s'admet per als controls d'altres parts de la pàgina, fins i tot si fan referència a la mateixa columna.

• Per als controls dins dels fluxos de processos de negoci, consulteu-los amb el prefix header_process_.
• Els controls dins d'altres controls, com ara subquadrícules i controls de cronologia , no són compatibles.

Sintaxi

formContext.getControl(arg);

El mètode formContext.getControl(arg) és un mètode de drecera per accedir a formContext.ui.controls.get.

Paràmetre

arg: Opcional. Podeu accedir a un control d'un formulari passant un argument com a nom o com a valor d'índex del control d'un formulari. Per exemple: formContext.getControl("firstname") o formContext.getControl(0). Si el arg nom està mal escrit i no està al formulari, retorna un valor nul.

Quan no es proporciona el arg valor, retorna una matriu de tots els controls del formulari.

Valor de retorn

Tipus: Col·lecció d'objectes, Objecte o nul.

Descripció: Col·lecció d'objectes si utilitzeu el mètode sense cap paràmetre. Objecte o nul si utilitzeu el mètode amb un paràmetre. Si utilitzeu el nom com a paràmetre i hi ha diversos controls per a la mateixa columna, només es retorna el primer control.

Propina

Si voleu modificar tots els controls enllaçats a una columna d'un formulari, utilitzeu la col·lecció de controls dins del tipus de columna. Per exemple, per afegir notificacions a cada control enllaçat a la name columna, podeu fer el següent:

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

Articles relacionats

formulariContext