Partilhar 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. Nestes 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 suportam o OnChange evento. Os dados na coluna são validados antes e depois do OnChange evento.

O OnChange evento não ocorre se a coluna é alterada programaticamente usando o método attribute.setValue . Se desejar que os manipuladores de eventos para o OnChange evento sejam executados depois de definir o valor, você deve usar o formContext.data.entity attribute. método fireOnchange em seu código. O OnChange evento também não ocorre 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 ofereça suporte aoOnChange evento, a coluna é somente leitura no formulário, portanto, o evento não pode 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 precisa de uma ação a ser executada ou manipulada na resolução do código assíncrono. Isso causa problemas se o manipulador de resolução espera que o contexto do aplicativo permaneça o mesmo de 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 fazer com que um aplicativo não responda.

Métodos suportados para este evento

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

Colunas (referência da API do cliente)
Eventos (referência da API do cliente)
Eventos em formulários e grelhas em aplicações condicionadas por modelo

  • Last updated on