Freigeben über


ITfComposition::EndComposition-Methode (msctf.h)

Beendet eine Komposition.

Syntax

HRESULT EndComposition(
  [in] TfEditCookie ecWrite
);

Parameter

[in] ecWrite

Enthält ein Bearbeitungscooky, das den von ITfEditSession::D oEditSession abgerufenen Bearbeitungskontext identifiziert.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Wert BESCHREIBUNG
S_OK
Die Methode war erfolgreich.
E_UNEXPECTED
Dieser Wert ergibt sich in folgenden Fällen:
  • Die Komposition wurde beendet.
  • Der Aufrufer befindet sich in einem anderen Kompositionsschreibvorgang.
  • Der Aufrufer besitzt die Komposition nicht.
TF_E_NOLOCK
Der durch ecWrite identifizierte Bearbeitungskontext verfügt nicht über eine Lese-/Schreibsperre.

Hinweise

Diese Methode gibt das Composition-Objekt nicht frei, aber die ITfComposition-Methoden schlagen mit E_UNEXPECTED fehl, nachdem diese Methode aufgerufen wurde.

Kontextbesitzer sollten die ITFContextOwnerCompositionServices::TerminateComposition-Methode verwenden, um eine Komposition zu beenden.

Diese Methode bewirkt, dass die GUID_PROP_COMPOSING-Eigenschaft aus dem Text entfernt wird, der von der Komposition abgedeckt wird.

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

Weitere Informationen

ITfContextOwnerCompositionServices::TerminateComposition, ITfComposition-Schnittstelle, ITfEditSession::D oEditSession