ITextStoreACPSink::OnTextChange-Methode (textstor.h)

Artikel
03/04/2024

Wird aufgerufen, wenn sich der Text eines Dokuments ändert.

Syntax

HRESULT OnTextChange(
  [in] DWORD               dwFlags,
  [in] const TS_TEXTCHANGE *pChange
);

Parameter

[in] dwFlags

Enthält eine Reihe von Flags, die zusätzliche Informationen zur Textänderung angeben. Dies kann mindestens einer der folgenden Werte sein.

Wert	Bedeutung
0	Der Text wurde geändert.
TS_ST_CORRECTION	Der Text ist eine Transformation (Korrektur) vorhandener Inhalte, und alle speziellen Textmarkupinformationen (Metadaten) werden beibehalten, z. B. .wav Dateidaten oder ein Sprachbezeichner. Dieses Flag wird für Anwendungen verwendet, die dem ursprünglichen Text zugeordnete Daten beibehalten müssen.

[in] pChange

Zeiger auf eine TS_TEXTCHANGE-Struktur , die Textänderungsdaten enthält.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Wert	BESCHREIBUNG
S_OK	Die Methode war erfolgreich.
E_INVALIDARG	pChange ist ungültig.
E_OUTOFMEMORY	Ein Speicherbelegungsfehler ist aufgetreten.
TS_E_NOLOCK	Der TSF-Manager hält eine Sperre für das Dokument. Dies gibt in der Regel an, dass die Methode innerhalb einer anderen ITextStoreACP-Methode aufgerufen wurde, z. B. ITextStoreACP::SetText.

Hinweise

ITextStoreACPSink::OnTextChange wird nie aufgerufen, wenn der Text durch eine der ITextStoreACP-Schnittstellenmethoden wie ITextStoreACP::SetText oder ITextStoreACP::InsertTextAtSelection geändert wird.

Beim Aufrufen dieser Methode muss die Anwendung in der Lage sein, eine Dokumentsperre zu gewähren.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	textstor.h
DLL	Msctf.dll
Verteilbare Komponente	TSF 1.0 unter Windows 2000 Professional