formContext.getControl (Referencia da API do cliente)

Obtén un control sobre a forma.

Nota

getControl só funciona nos controis do corpo do formulario e da cabeceira. Non está soportado para controis noutros lugares da páxina, aínda que se refiran á mesma columna.

• Para controis dentro dos fluxos de procesos de negocio, consulte eles co prefixo header_process_.
• Non se admiten controis dentro doutros controis, como as subgrellas e os controis da liña de tempo .

Sintaxe

formContext.getControl(arg);

O método formContext.getControl(arg) é un método de atallo para acceder a formContext.ui.controls.get.

Parámetro

arg: Opcional. Pode acceder a un control nun formulario pasando un argumento como o nome ou o valor de índice do control nun formulario. Por exemplo: ouformContext.getControl("firstname"). formContext.getControl(0) Se o arg nome está escrito incorrectamente e non está no formulario, devolve un valor nulo.

Cando non se proporciona o arg valor, devolve unha matriz de todos os controis do formulario.

Devolver valor

Tipo: Colección de obxectos, Obxecto ou nulo.

Descrición: Colección de obxectos se usa o método sen ningún parámetro. Obxecto ou nulo se usa o método cun parámetro. Se usa o nome como parámetro e hai varios controis para a mesma columna, só se devolverá o primeiro control.

Suxestión

Se desexa modificar todos os controis enlazados a unha columna nun formulario, use a colección de controis dentro do tipo de columna. Por exemplo, para engadir notificación a cada control enlazado á name columna, pode facer o seguinte:

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

Artigos relacionados

Contexto do formulario