Pular para o conteúdo principal

Alternar o estado de um controle (ui_element.toggle)

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

Declaração​

estado, informacoes_ou_erro = ui_element.toggle(seletor_ou_elemento [, 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 }.
  • 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​

Usada para alternar interruptores, caixas de seleção e outros controles cujo estado confirmado possa ser lido. Pode retornar nil, "state unavailable" quando não for possível ler o estado do destino.

Exemplo​

local ui_element = require("ui_element")

ui_element.toggle({
title = "飞行模式",
role = "switch",
})