Evento validate

Descrição

Inicia quando o design de formulário e os dados se unem para criar o formulário e quando um campo perde o foco; por exemplo, quando um usuário clica ou usa a tecla Tab para sair de um campo. Esse evento é iniciado novamente sempre que o valor de um campo é alterado. Os cálculos e scripts colocados no evento validate fornecem um método para executar validações mais específicas do que as disponíveis na guia Valor da paleta Objeto.

Os cálculos e scripts do evento validate devem retornar true ou false (expresso em um formato adequado à linguagem de script) de acordo com a falha ou êxito da validação e não devem afetar a estrutura geral dos valores de formulário. Além disso, os cálculos e scripts não devem tentar fornecer um retorno ao usuário, pois este pode não estar usando o formulário em um aplicativo cliente, como o Acrobat.

Tipo

Evento de processamento

Suporte

Versão

XFA 2.1

Exemplo

Use esse evento para verificar os valores de objeto, especificamente nas situações em que os dados de objeto devem estar em conformidade com regras específicas. Por exemplo, é possível criar um script no evento validate para verificar se o campo de custo total de um formulário de pedido de compra não tem um valor negativo.

Para obter um exemplo detalhado de como usar o evento validate, consulte Definição de um campo como obrigatório no tempo de execução.