ITextRangeProvider::FindAttribute メソッド (uiautomationcore.h)

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

構文

HRESULT FindAttribute(
  [in]          TEXTATTRIBUTEID    attributeId,
  [in]          VARIANT            val,
  [in]          BOOL               backward,
  [out, retval] ITextRangeProvider **pRetVal
);

パラメーター

[in] attributeId

型: TEXTATTRIBUTEID

テキスト属性の識別子。 テキスト属性 ID の一覧については、「 テキスト属性識別子」を参照してください。

[in] val

型: VARIANT

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

[in] backward

種類: BOOL

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

[out, retval] pRetVal

種類: ITextRangeProvider**

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

戻り値

型: HRESULT

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

注釈

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

要件

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

関連項目

概念

ITextProvider

ITextRangeProvider

リファレンス

UI オートメーション プロバイダーの概要