Exibir código-fonte para Desenvolvedor:APIs/JavaScript/latromi.formEventFiringContext

{{DISPLAYTITLE:latromi.formEventFiringContext}}__NOTOC__
Objeto de contexto, passado como argumento para funções de callback chamadas antes do processamento de eventos.

== Sintaxe ==
<syntaxhighlight lang="JavaScript">
var formEventFiringContext = {
    eventKind: undefined,      
    eventName: undefined,
    form: undefined,
    field: undefined,
    cancel: false,
    completeCallback: undefined
};
</syntaxhighlight>

== Propriedades ==
{|class="wikitable apidoctable2"
! Nome
! Descrição
|----------------------------------
| eventKind
| Tipo de evento, do tipo ''String''. O valor dessa propriedade pode ser:
* '''Form''': Se for um evento de Formulário.
* '''Field''': Se for um evento de campo do Formulário.
* '''Windows''': Se for um evento de Janela de Formulário.
|-
| eventName
| Nome do Evento, do tipo ''String''. Exemplo: ''Load'', ''LostFocus'', ''Click'' e ''WindowClosed''.
|-
| field
| Obtém a instância de [[DEV:APIs/JavaScript/latromi.fieldInstance|fieldInstance]], referente ao campo que disparou o evento. Se não for um evento de campo, esta propriedade terá valor ''null''.
|-
| form
| Obtém a instância de [[DEV:APIs/JavaScript/latromi.formInstance|formInstance]]. Esta propriedade terá valor quando for um evento de Formulário ou de membros de Formulário (Campos e Janelas).
|- 
| cancel
| Cancelamento do Evento, do tipo ''Boolean''. Se for especificado '''true''' nesta propriedade, o evento não será processado no servidor.
|}

== Exemplo ==
<syntaxhighlight lang="JavaScript">
latromi.formManager.setOnEventFiringCallback( function(context) {
   if (context.eventKind === 'Field')
      console.log('Evento ' + context.eventName + ' do campo ' + context.field.name + ' disparado.');
   else
      console.log('Evento ' + context.eventName + ' disparado.')
});
</syntaxhighlight>

== Métodos ==
{|class="wikitable apidoctable2"
! Nome
! Descrição
|----------------------------------
| completeCallback(function)
| Função para passar um callback que será chamado quando o processamento do evento no servidor for concluído.
|}