Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Os eventos iniciam todo o código do lado do cliente. Em aplicativos controlados por modelo, você associa uma função específica em uma biblioteca JavaScript (recurso da Web de script) a ser executada quando ocorre um evento. Essa função é chamada de manipulador de eventos. Cada manipulador de eventos especifica uma única função dentro de uma biblioteca JavaScript e quaisquer parâmetros que possam ser passados para a função.
Você pode associar manipuladores de eventos a apenas alguns eventos usando a interface do usuário. Para eventos que não estão disponíveis para serem associados por meio da interface do usuário, a API do Cliente fornece métodos que podem ser usados para anexar manipuladores de eventos a esses eventos.
Adicionar ou remover função de manipulador de eventos para evento usando a interface do usuário
Use a seção Manipuladores de Eventos da caixa de diálogo Propriedades do Formulário para associar seu script a um evento para formulários e colunas.
Editar formulários em massa
Por padrão, os manipuladores de eventos não são chamados quando um formulário está no modo de edição em massa.
Para habilitar um manipulador de eventos no modo de edição em massa, modifique o XML do formulário localizando o elemento relevante event e criando/definindo o BehaviorInBulkEditForm atributo como Enabled. Atualmente, isso só é suportado para eventos OnLoad.
Para obter mais informações sobre a personalização XML do formulário, consulte Quando editar o arquivo de personalizações, Personalizar formulários e o esquema XML do formulário.
Para determinar quando um manipulador de eventos é chamado em um formulário no modo de edição em massa, use getFormType o método.
Adicionar ou remover função de manipulador de eventos para evento usando código
Usando os seguintes métodos para adicionar e remover manipulador de eventos para eventos que não podem ser associados por meio da interface do usuário:
| Events | Manipulador de eventos |
|---|---|
| Atributo OnChange | métodos addOnChange e removeOnChange |
| Formulário OnLoad | métodos formContext.ui addOnLoad e removeOnLoad |
| Formulário carregado | métodos formContext.ui addLoaded e removeLoaded |
| Dados do formulário OnLoad | métodos formContext.data addOnLoad e removeOnLoad |
| Formulário OnSave | métodos addOnSave e removeOnSave |
| Pré-pesquisa de controlo de pesquisa | métodos addPreSearch e removePreSearch |
| controle kbsearch OnResultOpened | métodos addOnResultOpened e removeOnResultOpened |
| controle kbsearch OnSelection | métodos addOnSelection e removeOnSelection |
| controle kbsearch PostSearch | métodos addOnPostSearch e removeOnPostSearch |
Importante
O contexto de execução é automaticamente passado como o primeiro parâmetro para funções que são definidas usando o código. Para obter mais informações: Contexto de execução da API do cliente
Pipeline de eventos de formulário
Você pode definir até 50 manipuladores de eventos para cada evento. Cada manipulador de eventos é executado na ordem em que é exibido na seção Manipuladores de Eventos na guia Eventos da caixa de diálogo Propriedades do Formulário .
Use os métodos setSharedVariable e getSharedVariable para passar uma variável comum entre manipuladores de eventos (funções). Use o método getDepth de contexto de execução para saber a sequência em que um manipulador de eventos está sendo executado em relação a outros manipuladores de eventos.
Artigos relacionados
Compreender o modelo de objeto de API de Cliente
Contexto de execução da API do cliente
Eventos (referência da API do cliente)