iTfProperty：：Clear 方法 (msctf.h)

  • 项目

清空指定范围内的属性值。

语法

HRESULT Clear(
  [in] TfEditCookie ec,
  [in] ITfRange     *pRange
);

parameters

[in] ec

包含标识编辑上下文的编辑 Cookie。 这是从 ITfDocumentMgr：：CreateContext 或 ITfEditSession：:D oEditSession 获取的。

[in] pRange

指向 ITfRange 接口的指针，该接口包含清除属性的范围。 如果此参数为 NULL，则会清除整个编辑上下文中此属性的所有值。

返回值

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

值 说明
S_OK
 方法成功。
E_INVALIDARG
 pRange 无效。
TF_E_NOLOCK
 ec 标识的编辑上下文没有读/写锁。
TF_E_READONLY
 编辑上下文是只读的。
TF_E_NOTOWNEDRANGE
 TSF 管理器不拥有该范围。

注解

当上下文即将被销毁时，无需调用此方法。 从上下文堆栈中删除上下文时，TSF 管理器将清除所有属性。

要求

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

另请参阅

ITfDocumentMgr：：CreateContext

ITfEditSession：:D oEditSession

ITfProperty

ITfRange