ITextProvider::RangeFromPoint メソッド (uiautomationcore.h)

指定した画面座標の最も近くにある低次元 (空の) テキスト範囲を返します。

構文

HRESULT RangeFromPoint(
  [in]          UiaPoint           point,
  [out, retval] ITextRangeProvider **pRetVal
);

[in] point

種類: UiaPoint

画面座標での位置。

[out, retval] pRetVal

指定した場所に最も近い縮退 (空) テキスト範囲へのポインターを受け取ります。このパラメーターは初期化せずに渡されます。

型: HRESULT

このメソッドは、成功すると S_OK を返します。そうでない場合は、HRESULT エラーコードを返します。

画面座標が画像、ハイパーリンク、またはその他の埋め込みオブジェクトの座標内にある場合は、子オブジェクトを囲むテキスト範囲が返されます。

ITextProvider::RangeFromPoint では非表示のテキストは無視されないため、指定されたポイントに最も近い表示テキストから縮退した範囲が返されます。

プロパティは NULL を返しません。

要件	値
サポートされている最小のクライアント	Windows XP [デスクトップアプリ \| UWP アプリ]
サポートされている最小のサーバー	Windows Server 2003 [デスクトップアプリのみ \| UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	uiautomationcore.h (UIAutomation.h を含む)