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

座標位置の UI 要素を取得する (ui_element.text_element_at_position)

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

宣言​

要素, エラー情報 = ui_element.text_element_at_position(横座標, 縦座標 [, プロセス ID またはオプション ])

引数​

  • 横座標、縦座標 整数型。物理ピクセル単位の画面座標です。
  • プロセス ID またはオプション 省略可能な整数型またはテーブル型。整数型は対象 App のプロセス ID を示します。テーブル型については共通オプションの説明を参照してください。

戻り値​

  • 要素 テーブル型。指定した座標でヒットした UI 要素です。失敗した場合は nil です。
  • エラー情報 文字列型。失敗した理由です。

説明​

このインターフェースは、座標がすでに分かっている場合に、その位置の UI 要素を逆引きする用途に適しています。たとえば、画像認識や OCR の結果から周辺のコントロールを把握できます。 これは座標クリック用のインターフェースではありません。固定座標をクリックする場合は、touch.tap を使用してください。 座標位置が空白の場合や、対象画面が読み取り可能な要素を提供していない場合は失敗することがあります。

使用例​

local ui_element = require("ui_element")

local item, err = ui_element.text_element_at_position(300, 500, {
    include_hit_state = true,
    max_level = 1,
})

if item then
    nLog(item.text or item.value or "")
else
    sys.toast(err)
end

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