ITfRange::Clone method (msctf.h)

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

See also

ITfRange

Ranges

Text Stores