The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

ITfPropertyStore::Divide method

Syntax

C++


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

Parameters

pRangeThis [in]: Pointer to an ITfRange object that contains the range that the property store now covers. This will be the range of text closest to the beginning of the context.
pRangeNew [in]: Pointer to an ITfRange object that contains the range that the new property store will cover. This will be the range of text closest to the end of the context.
ppPropStore [out]: Pointer to an ITfPropertyStore interface pointer that receives a new property store object that will cover the range specified by pRangeNew.

Return value

This method can return one of these values.

Value	Description
S_OK	The method was successful.

Remarks

This method creates a new property store object to cover pRangeNew and returns the pointer to this object in ppPropStore. If no new property store is returned, the original property store is discarded and the property store for both ranges is set to empty.

If this method returns any value other than S_OK, the original property store is discarded.

Requirements

Minimum supported client	Windows 2000 Professional [desktop apps \| Windows Store apps]
Minimum supported server	Windows 2000 Server [desktop apps \| Windows Store apps]
Redistributable	TSF 1.0 on Windows 2000 Professional
Header	Msctf.h
IDL	Msctf.idl
DLL	Msctf.dll