iTfReadOnlyProperty：：EnumRanges 方法 (msctf.h)

获取包含给定范围内属性的唯一值的范围的枚举。

语法

HRESULT EnumRanges(
  [in]  TfEditCookie  ec,
  [out] IEnumTfRanges **ppEnum,
  [in]  ITfRange      *pTargetRange
);

[in] ec

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

[out] ppEnum

指向接收枚举器对象的 IEnumTfRanges 接口指针的指针。调用方在不再需要此对象时必须释放该对象。

[in] pTargetRange

指向 ITfRange 接口的指针，该接口指定要扫描的唯一属性值的范围。此参数是可选的，可以为 NULL。有关详细信息，请参见“备注”部分。

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

值	说明
S_OK	方法成功。
E_INVALIDARG	一个或多个参数无效。
E_OUTOFMEMORY	内存分配失败。
E_FAIL	发生了未指定的错误。注意如果应用程序未实现 ITextStoreACP：：FindNextAttrTransition，ITfReadOnlyProperty：：EnumRanges 将失败并E_FAIL。
TF_E_NOLOCK	ec 标识的编辑上下文没有只读或读/写锁。

注意： 如果应用程序未实现 ITextStoreACP：：FindNextAttrTransition， ITfReadOnlyProperty：：EnumRanges 将失败并E_FAIL。

此方法获取的枚举器将包含指定属性的每个唯一值（包括空值）的范围。例如，假设的颜色属性可以应用于以下标记文本：


COLOR:      RR      GGGGGGGG
TEXT:  this is some colored text

调用 ITfReadOnlyProperty：：EnumRanges 且 pTargetRange 设置为此范围时，枚举器将包含五个区域。

如果 pTargetRange 为 NULL，则枚举器将以包含上下文中非空属性值的第一个和最后一个范围开头和结尾。在上述示例中为 pTargetRange 指定 NULL 会导致枚举器具有三个范围。

枚举范围将以 pTargetRange 的开始和结束定位点开头和结束，即使任一定位点都定位在属性的中间。