メインコンテンツまでスキップ

テキスト要素の一覧を取得する (ui_element.list_text_elements)

この関数は 20260507 以降のバージョンでのみ使用できます

宣言​

要素一覧, エラー情報 = ui_element.list_text_elements([ プロセス ID またはオプション ])

引数​

  • プロセス ID またはオプション 省略可能な整数型またはテーブル型。整数型は対象 App のプロセス ID を示します。テーブル型については共通オプションの説明を参照してください。

戻り値​

  • 要素一覧 テーブル型。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 を使用しています。