ITextStoreAnchor::FindNextAttrTransition メソッド (textstor.h)

  • [アーティクル]

ITextStoreAnchor::FindNextAttrTransition メソッドは、属性値で遷移が発生するテキスト ストリーム内の場所を検索します。 チェックする指定された属性は、アプリケーションに依存します。

構文

HRESULT FindNextAttrTransition(
  [in]  IAnchor         *paStart,
  [in]  IAnchor         *paHalt,
  [in]  ULONG           cFilterAttrs,
  [in]  const TS_ATTRID *paFilterAttrs,
  [in]  DWORD           dwFlags,
  [out] BOOL            *pfFound,
  [out] LONG            *plFoundOffset
);

パラメーター

[in] paStart

属性遷移を検索する範囲の先頭にあるアンカー位置へのポインター。

[in] paHalt

属性遷移を検索する範囲の末尾にあるアンカー位置へのポインター。

[in] cFilterAttrs

チェックする属性の数を指定します。

[in] paFilterAttrs

チェックする属性を指定するTS_ATTRIDデータ型へのポインター。 定義済みの属性は tsattrs.h で指定されます。

[in] dwFlags

属性遷移を検索する方向を指定します。 既定では、メソッドは前方に検索します。

値 意味
TS_ATTR_FIND_BACKWARDS
 メソッドは、テキスト ストリーム内で後方に検索します。
TS_ATTR_FIND_UPDATESTART
 メソッドは、入力アンカー paStart を次の属性遷移 (見つかった場合) に配置します。 それ以外の場合、入力アンカーは変更されません。
TS_ATTR_FIND_WANT_OFFSET
 plFoundOffset パラメーターは、paStart から属性遷移の文字オフセットを受け取ります。

[out] pfFound

属性遷移が見つかった場合は ブール値 TRUE を受け取り、それ以外の場合は FALSE が返されます。

[out] plFoundOffset

開始アンカー paStart から属性遷移の文字オフセットを受け取ります。

戻り値

このメソッドは、これらの値のいずれかを返すことができます。

値 説明
S_OK
 メソッドは正常に実行されました。
E_INVALIDARG
 paStart または paHalt が無効です。
TS_E_INVALIDPOS
 指定された文字位置は、文書内のテキストを超えています。

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリ |UWP アプリ]
対象プラットフォーム Windows
ヘッダー textstor.h
[DLL] Msctf.dll
再頒布可能パッケージ Windows 2000 Professional 上の TSF 1.0

こちらもご覧ください

ITextStoreAnchor

TS_ATTRID

TS_ATTR_* 定数