Установка состояния флажка (ui_element.set_checked)

Функция доступна в версиях после 20260507.

Объявление

состояние, информация_или_ошибка = ui_element.set_checked(селектор_или_элемент, состояние_флажка [, параметры ])

Параметры

• Селектор или элемент
  Таблица: селектор, элемент, возвращённый поиском, или таблица координат { x = абсцисса, y = ордината }.
• Состояние флажка
  Логическое значение: true устанавливает включённое или выбранное состояние, false — выключенное или невыбранное.
• Параметры
  Необязательная таблица; см. описание общих параметров.

Возвращаемое значение

• Состояние
  Логическое значение: при успехе true, при ошибке nil.
• Информация или ошибка
  При успехе таблица с информацией о действии, при ошибке строка с причиной.

Описание

Если цель уже находится в заданном состоянии, интерфейс сразу возвращает успех. Целевой элемент должен предоставлять надёжное подтверждённое состояние.

Пример

local ui_element = require("ui_element")

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