ITfPropertyStore：:D ivide 方法 (msctf.h)

当属性涵盖的文本拆分为两个区域时调用。

语法

HRESULT Divide(
  [in]  ITfRange         *pRangeThis,
  [in]  ITfRange         *pRangeNew,
  [out] ITfPropertyStore **ppPropStore
);

[in] pRangeThis

指向 ITfRange 对象的指针，该对象包含属性存储现在涵盖的范围。这是最接近上下文开头的文本范围。

[in] pRangeNew

指向 ITfRange 对象的指针，该对象包含新属性存储将涵盖的范围。这是最接近上下文末尾的文本范围。

[out] ppPropStore

指向 ITfPropertyStore 接口指针的指针，该指针接收一个新的属性存储对象，该对象将涵盖 pRangeNew 指定的范围。

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

值	说明
S_OK	方法成功。

此方法创建一个新的属性存储对象来覆盖 pRangeNew ，并在 ppPropStore 中返回指向此对象的指针。如果未返回新的属性存储，则会丢弃原始属性存储，并将两个范围的属性存储设置为空。

如果此方法返回除 S_OK 以外的任何值，则会丢弃原始属性存储。