iTfProperty::SetValue 方法 (msctf.h)

设置范围的 属性的值。

语法

HRESULT SetValue(
  [in] TfEditCookie  ec,
  [in] ITfRange      *pRange,
  [in] const VARIANT *pvarValue
);

参数

[in] ec

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

[in] pRange

指向 ITfRange 接口的指针,该接口包含为其设置属性值的范围。 此参数不能为 NULL。 如果 pRange 为空,此方法将失败。

[in] pvarValue

指向包含新属性值的 VARIANT 结构的指针。 仅支持 VT_I4、VT_UNKNOWN、VT_BSTR 和 VT_EMPTY 类型的值。

返回值

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

说明
S_OK
方法成功。
E_INVALIDARG
一个或多个参数无效。
E_OUTOFMEMORY
发生内存分配失败。
E_FAIL
发生了未指定的错误。
TF_E_NOLOCK
ec 标识的编辑上下文没有读/写锁。
TF_E_READONLY
编辑上下文是只读的。
TF_E_NOTOWNEDRANGE
TSF 管理器不拥有该范围。

注解

修改属性值涵盖的文本时,将放弃使用此方法设置的属性值。 若要获得对文本编辑的值响应的自定义控制,请使用 ITfProperty::SetValueStore

使用此方法设置的值是序列化的,VT_UNKNOWN 类型的值除外,这些值未序列化。 如果必须序列化 VT_UNKNOWN 类型的属性值,请改用 ITfProperty::SetValueStore

不支持同一类型的重叠属性值。

要求

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

另请参阅

ITfDocumentMgr::CreateContext

ITfEditSession::D oEditSession

ITfProperty

ITfProperty::SetValueStore

ITfRange