Evento calculate

Descrição

Inicia nas seguintes situações:

• Quando o design de formulário e os dados se mesclam no formulário acabado.

• Quando ocorre uma alteração em qualquer valor do qual o cálculo depende, como o valor de um campo específico, a não ser que o valor calculado tenha sido manualmente suprimido pelo usuário. Como resultado, o objeto exibirá o valor de retorno do evento. As propriedades de campos manualmente suprimidos estão localizadas na guia Valor da paleta Objeto.

• Quando um campo perde o foco; por exemplo, quando um usuário clica ou usa a tecla Tab para sair de um campo.

  Quando o evento calculate for usado para executar cálculos ou scripts, considere os seguintes problemas em potencial:

• Os cálculos e scripts do evento calculate não devem alterar a estrutura do formulário, exceto para o campo de formulário e os valores de dados.

• O conteúdo inserido pelo evento calculate deve estar em conformidade com as validações associadas para o objeto; caso contrário, ocorrerão erros de validação.

• Os cálculos e scripts não devem incluir um loop infinito, pois isso atualiza o valor do formulário continuamente. Por exemplo, um script que aumenta o valor de um campo como parte de uma expressão de loop, como um loop while ou for, pode criar um loop infinito.

• A última expressão avaliada no evento calculate é usada para preencher o valor do objeto de formulário atual. Por exemplo, se o script no evento calculate primeiro definir o valor do campo atual como 500 e, em seguida, definir o valor de outro campo como 1000, ambos os campos exibirão o valor 1000 em tempo de execução. Como resultado, você precisa limitar o script que você adiciona ao evento calculate a aquele que lida especificamente com a definição do valor do campo atual.

Tipo

Evento de processamento

Suporte

Versão

XFA 2.1

Exemplo

Use o evento calculate para atualizar valores numéricos dos campos porque esse evento é iniciado imediatamente após a maioria dos outros eventos. Por exemplo, em um formulário de pedido de compra, é possível usar o evento calculate para um campo para determinada porcentagem devida da taxa de vendas com base no custo do pedido. O cálculo será iniciado sempre que uma alteração for feita nos valores dos campos de formulário, assegurando que o valor exibido para a taxa de vendas seja sempre correto.

No entanto, como o evento calculate pode ocorrer várias vezes, é necessário garantir que o cálculo ou script adicionado ao evento não aumentará os valores de dados desnecessariamente. Por exemplo, se o cálculo da taxa de vendas adiciona o valor dessa taxa ao custo total sempre que o evento calculate ocorre, o valor resultante do custo total no formulário pode ser muito grande.

Para obter um exemplo detalhado de como usar o evento calculate, consulte Como calcular as somas do campo.