Exibir código-fonte para Desenvolvedor:APIs/JavaScript/latromi.formManager/setOnFieldValueChangedCallback(function)

{{DISPLAYTITLE:Método setOnFieldValueChangedCallback(function)}}
Especifica uma [https://www.google.com/search?q=Função+de+Callback função de callback], que será chamada quando o valor de algum campo for alterado via programaticamente (via processamento no servidor ou API JavaScript). A função não será chamada quando o valor do campo for alterado pelo usuário.

'''Membro de:''' [[DEV:APIs/JavaScript/latromi.formManager|latromi.formManager]]
'''Uso'': Estático

== Sintaxe ==
<syntaxhighlight lang="JavaScript">
function setOnFieldValueChangedCallback(callback) { 
   var context = new latromi.fieldValueChangedContext();
   callback(context); 
}
</syntaxhighlight>

=== Parâmetros ===
: ''callback''
:: Tipo: function ([[DEV:APIs/JavaScript/latromi.fieldValueChangedContext|fieldValueChangedContext]])
:: Função de callback, esperando um parâmetro do tipo [[DEV:APIs/JavaScript/latromi.fieldValueChangedContext|fieldValueChangedContext]]. Neste parâmetro estarão disponíveis as informações de contexto do evento.

=== Valor de Retorno ===
: Sem retorno.

== Exemplos ==

=== Utilizando o contexto ===
O exemplo a seguir, mostra como interceptar o disparo de um evento do Formulário Dinâmico. O código executa as seguintes ações:
* Verifica se é um evento de campo.
* Se for um evento de campo, mostra no console do navegador o nome do campo e nome do evento disparado.
* Se for outro tipo de evento, mostra apenas o nome do evento.

<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>

=== Cancelando um evento ===
O exemplo a seguir, mostra como cancelar o processamento de um evento no servidor. O código executa as seguintes ações:
* Verifica se o evento disparado foi o ''Click'' do botão ''btnFakeButton''. Se for, executa as ações:
** Cancela o processamento do evento no servidor.
** Mostra no console do navegador uma mensagem notificando o cancelamento do evento.
<syntaxhighlight lang="JavaScript">
latromi.formManager.setOnEventFiringCallback( function(context) {
   if (context.eventKind   === 'Field' 
      && ontext.field.name === 'btnFakeButton' 
      && context.eventName === 'Click') 
   {
      context.cancel = true;
      console.log('O Evento Click do botão btnFakeButton foi cancelado.');
   }
});
</syntaxhighlight>