ITfProperty::SetValueStore 方法 (msctf.h)
使用属性存储对象为文本范围设置 属性的值。
语法
HRESULT SetValueStore(
[in] TfEditCookie ec,
[in] ITfRange *pRange,
[in] ITfPropertyStore *pPropStore
);
parameters
[in] ec
包含标识编辑上下文的编辑 Cookie。 这是从 ITfDocumentMgr::CreateContext 或 ITfEditSession::D oEditSession 获取的。
[in] pRange
指向 ITfRange 接口的指针,该接口包含为其设置属性值的范围。 此参数不能为 NULL。 如果 pRange 为空,此方法将失败。
[in] pPropStore
指向获取属性数据的 ITfPropertyStore 接口的指针。
返回值
此方法可以返回其中一个值。
值 | 说明 |
---|---|
|
方法成功。 |
|
一个或多个参数无效。 |
|
发生了未指定的错误。 |
|
ec 标识的编辑上下文没有读/写锁。 |
注解
修改属性值涵盖的文本时,将放弃使用 ITfProperty::SetValue 设置的属性值。 若要控制修改文本时属性值发生的情况,请使用 ITfProperty::SetValueStore 。
使用 ITfProperty::SetValue 设置的值将被序列化,VT_UNKNOWN 类型的值除外,这些值未序列化。 如果必须序列化 VT_UNKNOWN 类型的属性值,请改用 ITfProperty::SetValueStore 。
不支持同一类型的重叠属性值。
要求
最低受支持的客户端 | Windows 2000 专业版 [桌面应用 |UWP 应用] |
最低受支持的服务器 | Windows 2000 Server [桌面应用 |UWP 应用] |
目标平台 | Windows |
标头 | msctf.h |
DLL | Msctf.dll |
可再发行组件 | Windows 2000 专业版上的 TSF 1.0 |