Formulários › Criador de formulários › Funções de elemento do formulário › Elementos do formulário › Selecionar › ca_pam_selectOption(_id, name, value, isSelect)

ca_pam_selectOption(_id, name, value, isSelect)

Seleciona ou desmarca uma opção em um campo Selecionar com base no nome e no valor da opção. Também é possível usar essa função para impedir a seleção de uma opção específica.

Essa função pode selecionar e desmarcar uma opção. Se uma opção não estiver selecionada e você desejar selecioná-la programaticamente, então isSelect será true. Se uma opção já estiver selecionada e você desejar desmarcá-la, então use isSelect como false.

Parâmetros de entrada

_id (string)

Especifica a identificação exclusiva do campo Selecionar a ser definido.

name (string)

Especifica o nome da opção específica do campo Selecionar.

value (string)

Define o nome da opção específica do campo Selecionar. Esse valor é o valor existente da opção.

isSelect (boolean)

Especifica se o campo está selecionado (true) ou desmarcado (false).

Valor de retorno

Nenhum.

Exemplo

ca_pam_selectOption('Form.City', 'Regional Hub', 'Sydney', true);

Este exemplo define o campo Cidade para a opção nomeada Regional Hub.

Se várias opções forem nomeadas Regional Hub, então essa função se aplicará à opção com o valor especificado. Essa diferença é importante. Você pode utilizar o ca_pam_getSelectedOptionValues(_id) para identificar o valor específico para uma opção de campo, mesmo quando várias opções tiverem o mesmo nome. Por exemplo, os usuários podem continuar a utilizar um conjunto de formulários padrão para direcionar os negócios para a Central regional, mesmo que o valor seja alterado.