ITextStoreAnchorSink::OnTextChange-Methode (textstor.h)

Artikel
08/26/2023

Wird aufgerufen, wenn sich Text im Textstream ändert.

Syntax

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

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_TC_CORRECTION	Der Text ist eine Transformation (Korrektur) vorhandener Inhalte, und alle speziellen Textmarkierungsinformationen (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] paStart

Zeiger auf einen Anker, der sich am Anfang des geänderten Texts befindet.

[in] paEnd

Zeiger auf einen Anker, der sich am Ende des geänderten Texts befindet.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Wert	BESCHREIBUNG
S_OK	Die Methode war erfolgreich.
E_FAIL	Die Methode konnte keine geklonten Anker erstellen, um die Änderung zu enthalten.
E_INVALIDARG	paStart oder paEnd ist ungültig.
E_OUTOFMEMORY	Ein Fehler bei der Speicherzuordnung ist aufgetreten.
TS_E_NOLOCK	Der TSF-Manager hält eine Sperre für das Dokument bereit. Dies gibt in der Regel an, dass die Methode von einer anderen ITextStoreAnchor-Methode aufgerufen wurde, z. B. ITextStoreAnchor::SetText.

Hinweise

Diese Methode wird nur aufgerufen, wenn die Anwendung ihren eigenen Text ändert, nicht, wenn ein Client Text mit einer der ITextStoreAnchor-Methoden ändert, z. B. ITextStoreAnchor::SetText oder ITextStoreAnchor::InsertTextAtSelection.

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

Anforderungen


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