activity

Especifica o nome do evento.

A propriedade acompanhante ref deve especificar um objeto que possa gerar o evento nomeado.

Sintaxe

Reference_Syntax.activity = "change | click | docClose | docReady | enter | exit | full | initialize | mouseDown | mouseEnter | mouseExit | mouseUp | postExecute | postPrint | postSave | preExecute | prePrint | preSave | preSubmit | ready | validationState"

Valores

Tipo

Valor

String

change

Ocorre quando o usuário executa uma ação, como colar texto. A seguir, mais exemplos de ações que disparam o evento change:

  • Com cada tecla pressionada

  • Quando o texto é colado

  • Quando uma nova opção é selecionada

  • Quando uma caixa de seleção é marcada

  • Quando um item é selecionado

 

click (padrão)

Ocorre quando o usuário clica no campo. A maioria dos sistemas define o clique como pressionar e soltar o botão do mouse sem mover o ponteiro para além de um limite muito pequeno.

 

docClose 

Será executado no final do processamento de um formulário somente se todas as validações forem concluídas sem erros. Esse evento ocorre tarde demais para modificar um documento salvo. Sua finalidade é proporcionar a capacidade de gerar um status de saída ou uma mensagem de conclusão.

 

docReady 

É executado antes da renderização do documento, mas após a ocorrência do vínculo dos dados.

 

enter 

Para um campo, ocorre quando o campo recebe foco do teclado. Para um subformulário ou grupo de exclusão, ocorre quando um campo dentro do subformulário ou grupo de exclusão recebe foco do teclado, ou seja, o foco do teclado move de fora do objeto para dentro desse objeto.

 

enter 

Para um campo, ocorre quando o campo recebe foco do teclado. Para um subformulário ou grupo de exclusão, ocorre quando um campo dentro do subformulário ou grupo de exclusão recebe foco do teclado, ou seja, o foco do teclado move de fora do objeto para dentro desse objeto.

 

exit 

Para um campo, ocorre quando o campo perde o foco do teclado. Para um subformulário ou grupo de exclusão, ocorre quando todos os campos dentro do subformulário ou do grupo de exclusão perdem o foco do teclado, ou seja, o foco do teclado move de dentro do objeto para fora desse objeto.

 

full 

Inicia quando o usuário tenta inserir mais do que a quantia máxima permitida de conteúdo em um campo.

 

initialize 

É executado após a conclusão do vínculo de dados. Um evento separado é gerado para cada instância do subformulário no modelo de formulário.

 

mouseDown 

Ocorre quando o usuário pressiona o botão do mouse no campo, mas antes de soltar esse botão.

 

mouseEnter 

Ocorre quando o usuário arrasta o ponteiro sobre o campo, sem pressionar o botão necessariamente.

 

mouseExit 

Ocorre quando o usuário arrasta o ponteiro para fora do campo, sem pressionar o botão necessariamente.

 

mouseUp 

Ocorre quando o usuário solta o botão do mouse no campo.

 

postExecute 

Ocorre quando os dados são enviados a um serviço da Web via WSDL, logo após o recebimento da resposta para a solicitação e à organização dos dados recebidos em um objeto connectionData abaixo de $datasets. Um script acionado por esse evento tem a chance de examinar e processar os dados recebidos. Os dados recebidos são excluídos após a execução desse evento.

 

postPrint 

Ocorre logo após o envio do formulário renderizado para a impressora, o spooler ou o destino de saída.

 

postSave 

Ocorre logo após a gravação do formulário no formato PDF ou XDP. Não ocorre quando o modelo de dados ou outro subconjunto do formulário é exportado para XDP.

 

preExecute 

Ocorre quando uma solicitação é enviada a um serviço da Web via WSDL. Um script acionado por esse evento tem a chance de examinar e alterar os dados antes que a solicitação seja enviada. Se o script estiver marcado para ser executado somente no servidor, os dados serão enviados ao servidor com uma indicação de que devem executar o script associado antes que o restante do processamento seja realizado.

 

preSave 

Ocorre logo antes da gravação dos dados no formato PDF ou XDP. Não ocorre quando o modelo de dados ou outro subconjunto do formulário é exportado para XDP. O pós-processamento XSLT, se ativado, ocorre após esse evento.

 

preSubmit 

Ocorre quando os dados são submetidos ao host por meio do protocolo HTTP. Um script acionado por esse evento pode examinar e alterar os dados antes que eles sejam submetidos. Se o script estiver marcado para ser executado no servidor, os dados serão enviados ao servidor com uma indicação de que devem executar o script associado antes que o restante do processamento seja realizado.

 

ready 

Ocorre quando o modelo acaba de ser carregado.

 

validationState

É acionado quando o estado de validação de um campo, subformulário ou grupo de exclusão é alterado. O estado de validação é considerado alterado quando transita entre um estado válido e inválido, ou quando o teste que causou o estado inválido é alterado.

A finalidade do uso do evento é alterar a aparência dos campos quando eles se tornam válidos ou inválidos.

A propriedade event.target é preenchida com o objeto de contêiner cujo estado de validação foi alterado.

A propriedade event.name é preenchida com o nome da atividade (validationState).

Quando um campo, grupo de exclusão ou subformulário é inicializado, o evento validationState é acionado imediatamente após o evento initialize desse objeto.

O evento deve ser acionado novamente somente quando o estado de validação for alterado. Entretanto, a lógica do formulário deve ser robusta o suficiente para permitir que o evento seja acionado se o estado de validação não for realmente alterado.

O evento validationState é acionado somente depois que o estado de validação é avaliado para todos os objetos incluídos na operação de validação.

Você pode avaliar se o destino do evento é válido testando se a propriedade $event.target.errorText possui um valor.

Aplica-se a

Versão

XFA 2.1

Exemplos

JavaScript

TextField1.event.activity = "mouseEnter";

FormCalc

TextField1.event.activity = "mouseEnter"