UI 要素または現在のページをスクロールする (ui_element.scroll)

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

宣言

状態, 情報またはエラー情報 = ui_element.scroll(方向 [, オプション ])
状態, 情報またはエラー情報 = ui_element.scroll(セレクターまたは要素, 方向 [, オプション ])

引数

• セレクターまたは要素 省略可能なテーブル型。セレクター、検索で返された要素、または座標テーブル { x = 横座標, y = 縦座標 } を指定できます。
• 方向 文字列型。"down"、"up"、"left"、"right"、"top"、"bottom" に対応しています。
• オプション 省略可能なテーブル型。point、x、y でヒット位置を指定でき、steps でステップパラメータを指定できます。

戻り値

• 状態 ブール型。成功した場合は true、失敗した場合は nil です。
• 情報またはエラー情報 成功した場合はテーブル型の操作情報、失敗した場合は文字列型のエラー理由です。

説明

セレクターを渡さない場合は、既定で現在のページのスクロールを試みます。 セレクターを渡した場合は、対象要素を含むスクロール可能な領域のスクロールを試みます。 複数ページ分を確実にスクロールする必要がある場合は、Lua スクリプト内で繰り返し呼び出し、ページの変化を確認してください。

使用例

local ui_element = require("ui_element")

ui_element.scroll("down", {
    point = { x = 200, y = 700 },
})

ui_element.scroll({
    text_contains = "列表",
}, "up")