Adicionar texto à entrada (ui_element.input_text)

Esta função está disponível somente a partir da versão 20260507.

Declaração

estado, informacoes_ou_erro = ui_element.input_text(seletor_ou_elemento, texto [, opcoes])

Parâmetros

• seletor_ou_elemento
  Tabela; pode ser um seletor, um elemento retornado por uma consulta ou uma tabela de coordenadas { x = coordenada_x, y = coordenada_y }.
• texto
  Texto a ser adicionado à entrada.
• opcoes
  Tabela opcional; consulte Descrição das opções comuns.

Valores retornados

• estado
  Booleano; true em caso de sucesso e nil em caso de falha.
• informacoes_ou_erro
  Informações de ação em formato de tabela em caso de sucesso; motivo da falha em formato de texto em caso de erro.

Descrição

Esta interface primeiro localiza o destino de entrada de texto e depois adiciona o texto. Para substituir o texto existente, use set_text.

Exemplo

local ui_element = require("ui_element")

local ok, info_or_err = ui_element.input_text({
    title = "搜索",
    role = "text_field",
}, "XXTouch")

if not ok then
    sys.toast(info_or_err)
end

Observação: o código acima usa a função sys.toast, que não pertence a este capítulo.