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

  • [アーティクル]

ITextStoreACP::FindNextAttrTransition メソッドは、属性値で遷移が発生する文字位置を決定します。 チェックする指定された属性は、アプリケーションに依存します。

構文

HRESULT FindNextAttrTransition(
  [in]  LONG            acpStart,
  [in]  LONG            acpHalt,
  [in]  ULONG           cFilterAttrs,
  [in]  const TS_ATTRID *paFilterAttrs,
  [in]  DWORD           dwFlags,
  [out] LONG            *pacpNext,
  [out] BOOL            *pfFound,
  [out] LONG            *plFoundOffset
);

パラメーター

[in] acpStart

属性遷移の検索を開始する文字位置を指定します。

[in] acpHalt

属性遷移の検索を終了する文字位置を指定します。

[in] cFilterAttrs

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

[in] paFilterAttrs

チェックする属性を指定するTS_ATTRIDデータ型へのポインター。

[in] dwFlags

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

値 説明
TS_ATTR_FIND_BACKWARDS
 メソッドは後方に検索します。
TS_ATTR_FIND_WANT_OFFSET
 plFoundOffset パラメーターは、acpStart から属性遷移の文字オフセットを受け取ります。

[out] pacpNext

属性遷移のチェックする次の文字位置を受け取ります。

[out] pfFound

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

[out] plFoundOffset

属性遷移の文字位置を受け取ります (ACP 位置ではありません)。 TS_ATTR_FIND_WANT_OFFSET フラグが dwFlags で設定されている場合、 acpStart から属性遷移の文字オフセットを受け取ります。

戻り値

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

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

解説

メモ アプリケーションが ITextStoreACP::FindNextAttrTransition を実装していない場合、 ITfReadOnlyProperty::EnumRanges はE_FAILで失敗します。
 

要件

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

関連項目

ITextStoreACP

TS_ATTRID

TS_ATTR_* 定数