Mudanças entre as edições de "Desenvolvedor:APIs/JavaScript/latromi.formManager/setOnFormCreatedCallback(function)"

De LATROMI Manuais
Desenvolvedor:APIs/JavaScript/latromi.formManager/setOnFormCreatedCallback(function)
Ir para: navegação, pesquisa
(→‎Inicializando um Objeto ao criar o Formulário)
 
(7 revisões intermediárias pelo mesmo usuário não estão sendo mostradas)
Linha 1: Linha 1:
−
{{DISPLAYTITLE:Método setOnFormCreatedCallback()}}__NOTOC__
+
{{DISPLAYTITLE:Método setOnFormCreatedCallback(function)}}__NOTOC__
 
Especifica uma [https://www.google.com/search?q=Função+de+Callback 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.
 
Especifica uma [https://www.google.com/search?q=Função+de+Callback 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.
  
Linha 7: Linha 7:
 
<syntaxhighlight lang="JavaScript">
 
<syntaxhighlight lang="JavaScript">
 
function setOnFormCreatedCallback(callback) {  
 
function setOnFormCreatedCallback(callback) {  
−
   var arguments = {
+
   var context = new latromi.formCreatedContext();
−
      form: { } // Instância de latromi.formInstance
+
   callback(context);  
−
  };
+
}
−
   callback(arguments);  
+
</syntaxhighlight>
−
}</syntaxhighlight>
 
−
 
 
 
=== Parâmetros ===
 
=== Parâmetros ===
 
: ''callback''
 
: ''callback''
−
:: Tipo: function (object)
+
:: Tipo: function ([[DEV:APIs/JavaScript/latromi.formCreatedContext|formCreatedContext]])
−
:: Função de callback, esperando um parâmetro do tipo ''Object''. Neste parâmetro estarão disponíveis as informações de contexto do evento.
+
:: 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 ===
 
=== Valor de Retorno ===
−
Sem retorno.
+
: Sem retorno.
  
 
== Exemplos ==
 
== Exemplos ==
−
 
+
=== Inicializando um Objeto ao criar o Formulário ===
−
 
+
O exemplo a seguir mostra como inicializar um objeto que será usado apenas em um Formulário específico. O código executa as seguintes ações:
−
Exemplo:
+
* 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">
 
<syntaxhighlight lang="JavaScript">
−
function getFormInstance() {
+
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();
 +
  }
 +
});
 
</syntaxhighlight>
 
</syntaxhighlight>

Edição atual tal como às 21h50min de 9 de julho de 2018

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 (formCreatedContext)
Função de callback, esperando um parâmetro do tipo 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 um objeto que será usado 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.
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();
   }
});
Disponível em "http://docs.latromi.com.br/index.php?title=Desenvolvedor:APIs/JavaScript/latromi.formManager/setOnFormCreatedCallback(function)&oldid=1845"