Mudanças entre as edições de "Desenvolvedor:APIs/JavaScript/latromi.formInstance/setFieldValue(string,any)"

De LATROMI Manuais
Desenvolvedor:APIs/JavaScript/latromi.formInstance/setFieldValue(string,any)
Ir para: navegação, pesquisa
(Criou página com '{{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...')
 
(Obtendo valor dos campos do Formulário)
Linha 21: Linha 21:
  
 
== Exemplos ==
 
== Exemplos ==
=== Obtendo valor dos campos do Formulário ===
+
=== Atribuindo valor aos campos do Formulário ===
O Exemplo abaixo exibe no console do navegador o nome completo de uma pessoa, no formato brasileiro ou internacional. O código executa as seguintes ações:
+
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.
 
* Obtém uma instância do Formulário.
* Obtém o valor das ''TextBoxes'' '''txtFirstName''' e '''txtLastName''' e da ''CheckBox'' '''chkIsInternational'''.
+
* Atribui o texto "Bob" a ''TextBox'' '''txtFirtName'''.
* Se a ''CheckBox'' '''chkIsInternational''' estiver marcada, a mensagem será exibida em inglês no console do navegador, se não em português.
+
* Atribui o texto "Dylan" a ''TextBox'' '''txtLastName'''.
 +
* Atribui o valor booleano ''true'' a ''CheckBox'' '''chkIsInternational'''.
  
 
<syntaxhighlight lang="JavaScript">
 
<syntaxhighlight lang="JavaScript">

Edição das 16h37min de 9 de julho de 2018

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: latromi.formInstance

Sintaxe

function setFieldValue(fieldName, value) { }

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.
  • Atribui o texto "Bob" a TextBox txtFirtName.
  • Atribui o texto "Dylan" a TextBox txtLastName.
  • Atribui o valor booleano true a CheckBox chkIsInternational.
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);
}