IUIAutomationTextRange::FindAttribute メソッド (uiautomationclient.h)

指定したテキスト属性値を持つテキスト範囲サブセットを取得します。

構文

HRESULT FindAttribute(
  [in]          TEXTATTRIBUTEID        attr,
  [in]          VARIANT                val,
  [in]          BOOL                   backward,
  [out, retval] IUIAutomationTextRange **found
);

パラメーター

[in] attr

型: TEXTATTRIBUTEID

取得するテキスト範囲サブセットのテキスト属性の識別子。 テキスト属性 ID の一覧については、「 テキスト属性識別子」を参照してください。

[in] val

型: VARIANT

属性の値。 この値は、属性に指定されている型と一致する必要があります。

[in] backward

種類: BOOL

最初 のテキスト範囲ではなく、最後に発生したテキスト範囲を返す必要がある場合は TRUE。それ以外の場合 は FALSE。

[out, retval] found

種類: IUIAutomationTextRange**

一致する属性と属性値を持つテキスト範囲へのポインターを受け取ります。それ以外の場合 は NULL。

戻り値

型: HRESULT

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

注釈

FindAttribute メソッドは、テキストが非表示か表示かに関係なく、一致するテキストを取得します。 テキストの可視性をチェックするには、UIA_IsHiddenAttributeIdを使用します。

要件

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

こちらもご覧ください

IUIAutomationTextRange

テキスト コンテンツのUI オートメーションサポート