ITfTextEditSink::OnEndEdit-Methode (msctf.h)

Artikel
03/04/2024

Empfängt eine Benachrichtigung nach Abschluss einer ITfEditSession::D oEditSession-Methode, die Lese-/Schreibzugriff auf den Kontext hat.

Syntax

HRESULT OnEndEdit(
  [in] ITfContext    *pic,
  [in] TfEditCookie  ecReadOnly,
  [in] ITfEditRecord *pEditRecord
);

Parameter

[in] pic

Zeiger auf die ITfContext-Schnittstelle für den bearbeiteten Kontext.

[in] ecReadOnly

Gibt einen TfEditCookie-Wert für schreibgeschützten Zugriff auf den Kontext an.

[in] pEditRecord

Zeiger auf die ITfEditRecord-Schnittstelle , die für den Zugriff auf die Änderungen am Kontext verwendet wird.

Rückgabewert

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Eine Bearbeitungssitzung mit Lese-/Schreibzugriff wird mit einem Aufruf der ITfContext::RequestEditSession-Methode mithilfe des TF_ES_READWRITE-Flags angefordert, das eine ITfEditSession::D oEditSession-Methode zum Ausführen der Sitzung erstellt. Wenn eine solche ITfEditSession::D oEditSession-Methode abgeschlossen ist, ruft TSF diese Methode auf.

Ein Textdienst kann den ecReadOnly-Parameter nur verwenden, um den Kontext anzuzeigen. Wenn Änderungen erforderlich sind, muss der Textdienst einen asynchronen Aufruf der ITfContext::RequestEditSession-Methode verwenden. Ein Textdienst sollte jedoch nur Text ändern, den er zuvor als Teil einer Komposition eingegeben hat. Andernfalls könnten zwei oder mehr Textdienste denselben Text wiederholt ändern. Ein Textdienst kann die ITfContext::InWriteSession-Methode verwenden, um zu bestimmen, ob die abgeschlossene Bearbeitungssitzung ausgeführt wurde.

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	msctf.h
DLL	Imekrcic.dll
Verteilbare Komponente	TSF 1.0 unter Windows 2000 Professional