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

  • [アーティクル]

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

構文

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

パラメーター

[in] text

種類: BSTR

検索対象の文字列。

[in] backward

種類: BOOL

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

[in] ignoreCase

種類: BOOL

大文字 と小文字を区別しない場合は TRUE。それ以外の場合 は FALSE。

[out, retval] pRetVal

種類: ITextRangeProvider**

指定したテキストに一致するテキスト範囲へのポインターを受け取ります。それ以外の場合 は NULL。 このパラメーターは初期化せずに渡されます。

戻り値

型: HRESULT

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

注釈

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

要件

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

関連項目

概念

ITextProvider

ITextRangeProvider

リファレンス

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