IUIAutomationTextPattern::RangeFromPoint メソッド (uiautomationclient.h)

指定した画面座標に最も近い縮退 (空) テキスト範囲を取得します。

構文

HRESULT RangeFromPoint(
  [in]          POINT                  pt,
  [out, retval] IUIAutomationTextRange **range
);

[in] pt

種類: POINT

位置を画面座標で格納する構造体。

[out, retval] range

指定した場所に最も近い、縮退したテキスト範囲へのポインターを受け取ります。

型: HRESULT

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

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

非表示のテキストは無視されないため、このメソッドは、指定した座標に最も近い表示テキストから縮退範囲を取得します。

Windows インターネットエクスプローラー 9 での RangeFromPoint の実装では、期待される結果は返されません。代わりに、クライアントは次の手順を実行する必要があります。

GetVisibleRanges メソッドを呼び出して、表示されるテキスト範囲の配列を取得します。
配列内のテキスト範囲ごとに IUIAutomationTextRange::GetBoundingRectangles を呼び出して、外接する四角形を取得します。
外接する四角形を調べて、特定の画面座標を占めるテキスト範囲を見つけます。

要件	値
サポートされている最小のクライアント	Windows 7、Windows Vista SP2 と Windows Vista 用プラットフォーム更新プログラム、WINDOWS XP SP3 と Windows Vista 用プラットフォーム更新プログラム [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2008 R2、Windows Server 2008 SP2 および Windows Server 2008 用プラットフォーム更新プログラム、WINDOWS Server 2003 SP2 および Windows Server 2008 用プラットフォーム更新プログラム [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	uiautomationclient.h (UIAutomation.h を含む)