Ao criar cálculos e scripts, é necessário associar cada entrada a um evento de formulário específico. Cada evento de formulário representa uma alteração no seu estado que é iniciada em um momento específico.
A alteração no estado do formulário pode ocorrer durante a renderização do formulário no servidor pelo Forms ou no cliente pelo Acrobat ou Adobe Reader durante o preenchimento do formulário por um usuário.
Quando ocorre uma alteração no estado do formulário, qualquer cálculo ou script associado ao evento será processado automaticamente.
O evento usado ao criar um cálculo ou script pode, até certo ponto, determinar o que deve ser incluído neles. Por exemplo, a quantidade e o tipo de informação disponível em um formulário podem ser diferentes dependendo do momento escolhido para o evento, portanto, um cálculo ou script que recupera um valor de um campo pode ter diferentes resultados se for executado antes, e não depois, de o usuário realizar determinadas ações. Para obter mais informações sobre eventos, consulte Eventos.
Dependendo do tipo de formulário a ser criado, alguns eventos nunca ocorrem. Por exemplo, se for criado um formulário com layout fixo, sem objetos interativos, os eventos interativos associados às ações do usuário poderão nunca ocorrer e, consequentemente, nenhum script associado a eles será executado.
Embora o Designer ofereça suporte para uma ampla variedade de eventos de formulário, é possível realizar diversas tarefas comuns de cálculos e scripts usando apenas alguns eventos que ocorrem quando há grandes alterações no estado do formulário, como os seguintes:
- docReady
- É iniciado assim que o formulário é aberto no Acrobat ou no Adobe Reader e antes que o usuário comece a interagir com os objetos de formulário. Esse evento é o último que ocorre antes que seja fornecido controle do formulário ao usuário.
- enter
- É iniciado quando o usuário altera o foco para um determinado campo, botão ou subformulário.
- exit
- É iniciado quando o usuário altera o foco de um determinado campo, botão ou subformulário para outro objeto.
- change
- É iniciado quando o usuário altera para um valor de campo. Esse evento é usado com mais frequência com listas suspensas ou caixas de listagem para executar um script quando um usuário faz uma alteração no valor atual.
- click
- É iniciado quando o usuário clica em um campo ou botão. Esse evento é usado com mais frequência com botões para executar um script quando um usuário clica no botão.
