获取文本元素列表 (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