iTfReadOnlyProperty：：GetValue 方法 (msctf.h)

获取一系列文本的属性的值。

语法

HRESULT GetValue(
  [in]  TfEditCookie ec,
  [in]  ITfRange     *pRange,
  [out] VARIANT      *pvarValue
);

[in] ec

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

[in] pRange

指向 ITfRange 接口的指针，该接口指定要获取其属性的范围。

[out] pvarValue

指向接收属性值的 VARIANT 值的指针。此值的数据类型和内容由属性所有者定义，调用方必须识别才能使用此值。当不再需要此数据时，调用方必须通过将此值传递给 VariantClear API 来释放这些数据。

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

值	说明
S_OK	方法成功。
S_FALSE	属性未涵盖范围，或者范围包含多个属性值。 pvarValue 接收VT_EMPTY值。
E_INVALIDARG	一个或多个参数无效。
E_FAIL	发生了未指定的错误。
TF_E_NOLOCK	ec 标识的编辑上下文没有只读或读/写锁。

如果属性对 pRange 没有值， 则 pRange 包含属性的多个值，或者属性不完全覆盖 pRange， pvarValue 接收VT_EMPTY值，方法返回S_FALSE。


COLOR:      RR      GGGGGGGG
TEXT:  this is some colored text
    range--&gt;||&lt;-


COLOR:      RR      GGGGGGGG
TEXT:  this is some colored text
    range--&gt;|    |&lt;-


COLOR:      RR      GGGGGGGG
TEXT:  this is some colored text
    range--&gt;|             |&lt;-