ITextStoreAnchorSink::OnTextChange メソッド (textstor.h)

  • [アーティクル]

テキスト ストリーム内のテキストが変更されたときに呼び出されます。

構文

HRESULT OnTextChange(
  [in] DWORD   dwFlags,
  [in] IAnchor *paStart,
  [in] IAnchor *paEnd
);

パラメーター

[in] dwFlags

テキスト変更に関する追加情報を指定するフラグのセットが含まれます。 これには、次の値のうち 1 つ以上を指定できます。

値 説明
0
 テキストが変更されました。
TS_TC_CORRECTION
 テキストは既存のコンテンツの変換 (修正) であり、.wav ファイル データや言語識別子など、特別なテキスト マークアップ情報 (メタデータ) が保持されます。 このフラグは、元のテキストに関連付けられているデータを保持する必要があるアプリケーションに使用されます。

[in] paStart

変更されたテキストの先頭にあるアンカーへのポインター。

[in] paEnd

変更されたテキストの末尾にあるアンカーへのポインター。

戻り値

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

値 説明
S_OK
 メソッドは正常に実行されました。
E_FAIL
 メソッドは、変更を含む複製されたアンカーを作成できませんでした。
E_INVALIDARG
 paStart または paEnd が無効です。
E_OUTOFMEMORY
 メモリ割り当てエラーが発生しました。
TS_E_NOLOCK
 TSF マネージャーは、文書に対してロックを保持します。 これは通常、 ITextStoreAnchor::SetText などの別の ITextStoreAnchor メソッド内からメソッドが呼び出されたことを示 します。

解説

このメソッドは、クライアントが ITextStoreAnchor::SetText や ITextStoreAnchor::InsertTextAtSelection などの ITextStoreAnchor メソッドのいずれかを使用してテキストを変更する場合ではなく、アプリケーションが独自のテキストを変更する場合にのみ呼び出されます。

このメソッドを呼び出すとき、アプリケーションは ドキュメント ロックを許可できる必要があります。

要件

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

関連項目

ドキュメント ロック

ITextStoreAnchor

ITextStoreAnchor::InsertTextAtSelection

ITextStoreAnchor::SetText

ITextStoreAnchorSink

その他のテキスト ストア定数