Método setOnFormCreatedCallback(function)

De LATROMI Manuais
Desenvolvedor:APIs/JavaScript/latromi.formManager/setOnFormCreatedCallback(function) /
Revisão de 14h16min de 9 de julho de 2018 por Daniel.giacomelli (discussão | contribs) (Sintaxe)
Ir para: navegação, pesquisa

Especifica uma função de callback, que será chamada quando o processo de criação do Formulário Dinâmico na página for concluído. Este evento ocorre apenas uma vez para cada página carregada.

Membro de: latromi.formManager

Sintaxe

function setOnFormCreatedCallback(callback) { 
   var context = new latromi.formCreatedContext();
   callback(context); 

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

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

== Exemplos ==
=== Inicializando um Objeto ao criar o Formulário ===
O exemplo a seguir mostra como inicializar uma API que será usada apenas em um Formulário específico. O código executa as seguintes ações:
* Verifica se o formulário que foi criado na página é o detentor do Código de Atualização FRM00000267600002420180709131720350305.
* Se o teste acima for verdadeiro, inicializar o objeto '''myApi''', passando no construtor o valor do campo '''txtApiValue'''.
<syntaxhighlight lang="JavaScript">
var myApiInstance;

latromi.formManager.setOnFormCreatedCallback( function(context) {
   // Se for um formulário especifico, inicializa a API.
   if (context.form.upgradeCode === 'FRM00000267600002420180709131720350305') {
      myApiInstance = new myApi(context.form.getFieldValue('txtApiValue'));
      myApiInstance.init();
   }
});