Método setFieldValue(string, any)

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

Obtendo valor dos 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:

• Obtém uma instância do Formulário.
• Obtém o valor das TextBoxes txtFirstName e txtLastName e da CheckBox chkIsInternational.
• Se a CheckBox chkIsInternational estiver marcada, a mensagem será exibida em inglês no console do navegador, se não em português.

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);
}