设置勾选状态 (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)