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

{{DISPLAYTITLE:Método getFormInstance(string &#124; null)}}__NOTOC__
Função que retorna uma instância de [[Dev:APIs/JavaScript/latromi.formInstance|formInstance]].

'''Memebro de:''' [[DEV:APIs/JavaScript/latromi.formManager|latromi.formManager]]

== Sintaxe ==
<syntaxhighlight lang="JavaScript">
function getFormInstance(upgradeCode) { }
</syntaxhighlight>

=== Parâmetros ===
: ''upgradeCode''
:: Tipo: String
:: Código de atualização do Formulário Dinâmico. Este parâmetro é '''opcional'''. Se for especificado, o formManager vai procurar um formulário que contenha esse código. Caso contrário, vai retornar o primeiro Formulário encontrado.

=== Valor de Retorno ===
Retorna um objeto do tipo [[DEV:APIs/JavaScript/latromi.formInstance|latromi.formInstance]], referente a um Formulário Dinâmico carregado na tela.

== Exemplos ==

=== Obtendo o objeto formInstace ===
O exemplo abaixo mostra como obter uma instância do objeto '''formInstance'''. O código executa as seguintes ações:
* Obtém um objeto do tipo '''formInstance''', referente ao primeiro Formulário encontrado na página.
* Se o objeto foi encontrado, exibe no console do navegador o ''Código de Ataulização''.

<syntaxhighlight lang="JavaScript">
function getFormInstance() {
   // Obtém a instância do formulário
   var form = latromi.formManager.getFormInstance();
   if (form) {
      console.log('Form com UpgradeCode ' + form.upgradeCode + ' encontrado!');
   }
}
</syntaxhighlight>

== Ver Também ==
* [[DEV:APIs/JavaScript/latromi.formManager|Objeto latromi.formManager]]
* [[DEV:APIs/JavaScript|APIs JavaScript]]