TextPattern_RangeFromPoint関数 (uiautomationcoreapi.h)

  • [アーティクル]
メモ この関数は非推奨です。 クライアント アプリケーションでは、代わりに Microsoft UI オートメーション コンポーネント オブジェクト モデル (COM) インターフェイスを使用する必要があります。
 
指定した画面座標に最も近い縮退 (空) テキスト範囲を取得します。

構文

HRESULT TextPattern_RangeFromPoint(
  [in]  HUIAPATTERNOBJECT hobj,
  [in]  UiaPoint          point,
  [out] HUIATEXTRANGE     *pRetVal
);

パラメーター

[in] hobj

種類: HUIAPATTERNOBJECT

コントロール パターン オブジェクト。

[in] point

種類: HiaPoint

画面座標内の位置を含む UiaPoint 構造体。

[out] pRetVal

種類: HUIATEXTRANGE*

この関数から制御が戻るときに、ノードがまたがるテキスト範囲が格納されます。 このパラメーターは初期化せずに渡されます。

戻り値

型: HRESULT

成功した場合はS_OK、それ以外の場合はエラー値を返します。

解説

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

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

要件

   
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー uiautomationcoreapi.h
Library Uiautomationcore.lib
[DLL] Uiautomationcore.dll