Comando
SetText()
Define o texto de um campo de texto Win32 fazendo atribuição direta. Substitui o conteúdo atual do campo pelo texto informado.
SetText(identificador, texto [, appId [, ControlClick] [, SetFocus]])Parâmetros
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
identificador | Sim | Identificador do controle. Utilize a janela de configuração do comando para obter o identificador dos controles. |
texto | Sim | Texto a definir no campo. Use string vazia '' para limpar o campo. |
appId | Não | Identificador da aplicação gerenciada. |
ControlClick | Não | Informe ControlClick para enviar um clique ao controle antes de definir o texto. Útil para campos que precisam de clique para aceitar entrada. |
SetFocus | Não | Informe SetFocus para colocar o foco no controle antes de definir o texto. |
Exemplos
// Definir texto simples:
SetText('txtUsuario', 'joao.silva')
// Com ControlClick antes (para campos que exigem foco via clique):
SetText('txtPesquisa', $termo, 'erp', ControlClick)
// Limpar o campo:
SetText('txtObservacao', '')Observações
O SetText() geralmente é mais rápido que SendText() pois atribui diretamente sem simular digitação, mas pode não funcionar em controles que não suportam o padrão Win32 nativo. Aguarda até 90 segundos pela disponibilidade do controle.