取得文字元素清單 (ui_element.list_text_elements)

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

聲明

元素清單, 錯誤資訊 = ui_element.list_text_elements([ 行程號或選項 ])

參數

• 行程號或選項
  可選參數，整數型或表型。整數型表示目標 App 行程號；表型可參考 通用選項說明。

回傳值

• 元素清單
  表型，UI 元素陣列。失敗時為 nil。
• 錯誤資訊
  文字型，失敗原因。

說明

取得目前目標 App 的文字元素清單。 返回元素中的座標字段單位為物理像素。 該介面為兼容舊腳本保留，預設查詢策略較保守；新腳本需要定位元素時優先考慮 find 或 snapshot。

範例

local ui_element = require("ui_element")

local list, err = ui_element.list_text_elements({
    max_level = 1,
    include_hit_state = true,
})

if list then
    for _, item in ipairs(list) do
        if item.text then
            nLog(item.text)
        end
    end
else
    sys.toast(err)
end

注：上述代碼中使用了非本章函式 nLog、sys.toast