Pular para o conteúdo principal

Inserir texto (key.input_text)

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

Declaração​

sucesso, mensagem_de_erro = key.input_text(conteudo_do_texto [, pressionar_Enter_ao_concluir])

Parâmetros​

  • conteúdo_do_texto
    Texto UTF-8 a inserir, que pode estar vazio; "\b" executa uma operação de retrocesso.
  • pressionar_Enter_ao_concluir
    Booleano que indica se a tecla Enter deve ser pressionada depois que a entrada terminar; o padrão é false.

Valores retornados​

  • sucesso
    Booleano; retorna true quando a operação de entrada simulada é enviada com sucesso e false quando falha.
  • mensagem_de_erro
    Texto; retorna a causa da falha.

Descrição​

Insere texto no campo de entrada que já tem foco no aplicativo em primeiro plano, simulando a seleção de caracteres pelo método de entrada.

Esta função não lê nem modifica a área de transferência pública do sistema.

Esta função não consegue inserir texto em campos de senha; para campos de senha, use sys.input_text.

O retorno true indica apenas que a operação de entrada simulada foi enviada; não significa que o campo de destino necessariamente aceitou o texto.

Exemplo​

local ok, err = key.input_text("你好，XXTouch 🙂")
assert(ok, err)
--
local ok, err = key.input_text("hello!\b", true)
assert(ok, err)