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

指定したテキストを含むテキスト範囲のサブセットを取得します。

構文

HRESULT FindText(
  [in]          BSTR                   text,
  [in]          BOOL                   backward,
  [in]          BOOL                   ignoreCase,
  [out, retval] IUIAutomationTextRange **found
);

パラメーター

[in] text

種類: BSTR

検索対象のテキスト。

[in] backward

種類: BOOL

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

[in] ignoreCase

種類: BOOL

大文字 と小文字を無視する必要がある場合は TRUE。それ以外の場合 は FALSE。

[out, retval] found

種類: IUIAutomationTextRange**

テキスト範囲へのポインターを受け取ります。一致するものが見つからない場合は NULL を 受け取ります。

戻り値

種類: HRESULT

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

注釈

非表示のテキストと表示されるテキストは区別されません。

要件

要件	値
サポートされている最小のクライアント	Windows 7、Windows Vista SP2 と Windows Vista 用プラットフォーム更新プログラム、SP3 を使用した Windows XP、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 オートメーションサポート