ITfComposition::EndComposition 方法 (msctf.h)

终止组合。

语法

HRESULT EndComposition(
  [in] TfEditCookie ecWrite
);

parameters

[in] ecWrite

包含一个编辑 Cookie,用于标识从 ITfEditSession::D oEditSession 获取的编辑上下文。

返回值

此方法可以返回其中一个值。

说明
S_OK
方法成功。
E_UNEXPECTED
此值在以下情况下产生:
  • 组合已终止。
  • 调用方位于另一个组合写入操作中。
  • 调用方不拥有组合。
TF_E_NOLOCK
ecWrite 标识的编辑上下文没有读/写锁。

注解

此方法不会释放合成对象,但在调用此方法后, ITfComposition 方法将失败并E_UNEXPECTED。

上下文所有者应使用 ITFContextOwnerCompositionServices::TerminateComposition 方法来终止组合。

此方法使 GUID_PROP_COMPOSING 属性从合成所涵盖的文本中删除。

要求

   
最低受支持的客户端 Windows 2000 专业版 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows 2000 Server [桌面应用 |UWP 应用]
目标平台 Windows
标头 msctf.h
DLL Msctf.dll
可再发行组件 Windows 2000 专业版上的 TSF 1.0

另请参阅

ITfContextOwnerCompositionServices::TerminateCompositionITfComposition 接口ITfEditSession::D oEditSession