Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Obtém um controle no formulário.
Observação
getControl só funciona em controles no corpo do formulário e no cabeçalho. Não há suporte para controles em outros lugares da página, mesmo que eles se refiram à mesma coluna.
- Para controles dentro de fluxos de processos de negócios, consulte-os com o prefixo
header_process_. - Não há suporte para controles dentro de outros controles, como subgrades e controles de linha do tempo .
Sintaxe
formContext.getControl(arg);
O método formContext.getControl(arg) é um método de atalho para acessar formContext.ui.controls.get.
Parâmetro
arg: Opcional. Você pode acessar um controle em um formulário passando um argumento como o nome ou o valor de índice do controle em um formulário. Por exemplo: formContext.getControl("firstname") ou formContext.getControl(0). Se o arg nome estiver escrito incorretamente e não estiver no formulário, ele retornará o valor nulo.
Quando o arg valor não é fornecido, ele retorna uma matriz de todos os controles no formulário.
Valor de retorno
Type: Object collection, Object ou null.
Descrição: Coleção de objetos se você usar o método sem parâmetros. Object ou null se você usar o método com um parâmetro. Se você usar o nome como um parâmetro e houver vários controles para a mesma coluna, somente o primeiro controle será retornado.
Sugestão
Se você quiser modificar todos os controles vinculados a uma coluna em um formulário, use a coleção de controles dentro do tipo de coluna.
Por exemplo, para adicionar notificação a cada controle vinculado à name coluna, você pode fazer 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));