跳至主要內容

切換控制項狀態 (ui_element.toggle)

該函式在 20260507 以後版本方可使用

聲明​

狀態, 資訊或錯誤資訊 = ui_element.toggle(選擇器或元素 [, 選項 ])

參數​

  • 選擇器或元素
    表型,可以是 選擇器、查詢返回的元素,或 { x = 橫座標, y = 縱座標 } 座標表。
  • 選項
    可選參數,表型,可參考 通用選項說明。

回傳值​

  • 狀態
    布林型,成功時為 true,失敗時為 nil。
  • 資訊或錯誤資訊
    成功時為表型動作資訊,失敗時為文字型錯誤原因。

說明​

用於切換開關、勾選框或其它能讀取確認狀態的控制項。 如果無法讀取目標狀態,可能返回 nil, "state unavailable"。

範例​

local ui_element = require("ui_element")

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