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

画像、ハイパーリンク、Microsoft Excel スプレッドシート、その他の埋め込みオブジェクトなどの子要素を囲むテキスト範囲を取得します。

構文

HRESULT RangeFromChild(
  [in]          IUIAutomationElement   *child,
  [out, retval] IUIAutomationTextRange **range
);

[in] child

テキスト範囲で囲む子要素へのポインター。

[out, retval] range

子要素を囲むテキスト範囲へのポインターを受け取ります。

型: HRESULT

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

子要素を囲むテキストが範囲内に存在しない場合は、縮退した (空の) 範囲が返されます。

子パラメーターは、IUIAutomationTextPattern に関連付けられている要素の子であるか、IUIAutomationTextRange の子の配列から取得されます。

要件	値
サポートされている最小のクライアント	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 を含む)