ITfRange::Clone method (msctf.h)

Article
02/22/2024

The ITfRange::Clone method duplicates this range of text.

Syntax

HRESULT Clone(
  [out] ITfRange **ppClone
);

Parameters

[out] ppClone

Pointer to a new range object that references this range.

Return value

This method can return one of these values.

Value	Description
S_OK	The method was successful.
E_OUTOFMEMORY	The method was unable to generate a pointer to the new range.

Remarks

The resulting new range object can be modified without affecting the original. However, modifying the document that contains the new range might cause the original range's anchors to be repositioned.

The gravity of the original is preserved in the new range.

Requirements

Requirement	Value
Minimum supported client	Windows 2000 Professional [desktop apps \| UWP apps]
Minimum supported server	Windows 2000 Server [desktop apps \| UWP apps]
Target Platform	Windows
Header	msctf.h
DLL	Msctf.dll
Redistributable	TSF 1.0 on Windows 2000 Professional