Exibir código-fonte para Desenvolvedor:APIs/JavaScript/latromi.formInstance/setFieldValue(string,any)

{{DISPLAYTITLE:Método setFieldValue(string, any)}}__NOTOC__
Função que atribui valor a um campo. O valor especificado deve variar conforme o tipo de campo. Por exemplo, se form uma TextBox deve ser passado um valor do tipo String, mas se for uma CheckBox, deve ser um valor do tipo Booelan.

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

== Sintaxe ==
<syntaxhighlight lang="JavaScript">
function setFieldValue(fieldName, value) { }
</syntaxhighlight>

=== Parâmetros ===
: ''fieldName''
:: Tipo: String
:: Nome do campo que reberá o valor.
: ''value''
:: Tipo: Any
:: Valor a ser atribuído ao campo. O tipo de dados varia conforme o tipo de campo.

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

== Exemplos ==
=== Atribuindo valor aos campos do Formulário ===
O exemplo a seguir preenche alguns campos do Formulário Dinâmico. O código executa as seguintes ações:
* Obtém uma instância do Formulário.
* Preenche o campo '''txtFirtName''', do tipo ''TextBox'', com o texto <span class="codepart code-string">"Bob"</span>.
* Preenche o campo '''txtLastName''', do tipo ''TextBox'', com o texto <span class="codepart code-string">"Dylan"</span>.
* Marca a ''CheckBox'' chamada '''chkIsInternational''' informando o valor <span class="codepart code-boolean">true</span>.

<syntaxhighlight lang="JavaScript">
function populateFields() {
   // Obtém a instância do formulário
   var form = latromi.formManager.getFormInstance();
   
   // Preenche os campos
   form.setFieldValue('txtFirstName', 'Bob');
   form.setFieldValue('txtLastName', 'Dylan');
   form.setFieldValue('chkIsInternational', true);
}
</syntaxhighlight>