複数の UI 要素を検索する (ui_element.find_all)

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

宣言

要素一覧 = ui_element.find_all(セレクター [, オプション ])

引数

• セレクター テーブル型。検索する UI 要素を記述します。セレクターのフィールド説明を参照してください。
• オプション 省略可能なテーブル型。共通オプションの説明を参照してください。

戻り値

• 要素一覧 テーブル型。一致したすべての要素で構成される配列です。一致する要素がない場合は空の配列を返します。

説明

find_all は、同種のコントロールを列挙する場合や、先に一致件数を確認する場合に適しています。 最初に一致した要素だけが必要な場合は、find を使用する方が直接的です。

使用例

local ui_element = require("ui_element")

local items = ui_element.find_all({
    role = "button",
})

for i, item in ipairs(items) do
    nLog(i, item.text or "")
end

注記：上記のコードでは、この章で扱っていない関数 nLog を使用しています。