Compartilhar via

Evento Column OnChange (referência da API do Cliente)

O OnChange evento ocorre nas seguintes situações:

  • Os dados em uma coluna de formulário foram alterados e o foco foi perdido. Há uma exceção a esse comportamento que se aplica a colunas Sim/Não formatadas para usar botões de opção ou caixas de seleção. Nesses casos, o evento ocorre imediatamente.
  • As alterações de dados no servidor são recuperadas para atualizar uma coluna quando o formulário é atualizado, como depois que um registro é salvo.
  • O método attribute.fireOnchange é usado.

Todas as colunas dão suporte ao OnChange evento. Os dados na coluna são validados antes e depois do OnChange evento.

O OnChange evento não ocorrerá se a coluna for alterada programaticamente usando o método attribute.setValue . Se você quiser que os manipuladores de eventos para o OnChange evento seja executado depois de definir o valor, use o formContext.data.entity attribute. método fireOnchange em seu código. O OnChange evento também não ocorrerá se a coluna for alterada programaticamente ao descartar alterações se o usuário estiver navegando para longe de um formulário sujo.

Observação

Embora a coluna Status dê suporte aoOnChange evento, a coluna é somente leitura no formulário para que o evento não possa ocorrer por meio da interação do usuário. Outro script pode fazer com que esse evento ocorra usando o método fireOnchange na coluna.

Observação

OnChange os eventos são síncronos. Você não deve usar código assíncrono em um OnChange manipulador de eventos que precise de uma ação a ser tomada ou tratada na resolução do código assíncrono. Isso causará problemas se o manipulador de resolução espera que o contexto do aplicativo permaneça o mesmo que era quando o código assíncrono foi iniciado. Você também não deve fazer solicitações de rede síncronas em um manipulador de eventos OnChange. Isso pode causar um aplicativo sem resposta.

Métodos com suporte para este evento

Há três métodos que você pode usar para trabalhar com o OnChange evento para uma coluna:

Colunas (referência à API do Cliente)
Eventos (referência à API do cliente)
Eventos em formulários e grades em aplicativos baseados em modelos

  • Last updated on