Desenvolvedor:APIs/JavaScript/latromi.formInstance/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

Atribuindo valor aos campos do Formulário

<style scoped> .codepart { font-family:monospace;font-size:1.2em;} .codepart.code-string { color:magenta;} .codepart.code-boolean { color:#0000cc;} </style> 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 "Bob".
• Preenche o campo txtLastName, do tipo TextBox, com o texto "Dylan".
• Marca a CheckBox chamada chkIsInternational informando o valor true.

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