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,则会清除整个编辑上下文中此属性的所有值。
返回值
此方法可以返回其中一个值。
值 | 说明 |
---|---|
|
方法成功。 |
|
pRange 无效。 |
|
ec 标识的编辑上下文没有读/写锁。 |
|
编辑上下文是只读的。 |
|
TSF 管理器不拥有该范围。 |
注解
当上下文即将被销毁时,无需调用此方法。 从上下文堆栈中删除上下文时,TSF 管理器将清除所有属性。
要求
最低受支持的客户端 | Windows 2000 专业版 [桌面应用 |UWP 应用] |
最低受支持的服务器 | Windows 2000 Server [桌面应用 |UWP 应用] |
目标平台 | Windows |
标头 | msctf.h |
DLL | Msctf.dll |
可再发行组件 | Windows 2000 专业版上的 TSF 1.0 |