ITfRange::ShiftEndToRange method (msctf.h)

Moves the end anchor of this range to an anchor within another range.

Syntax

HRESULT ShiftEndToRange(
  [in] TfEditCookie ec,
  [in] ITfRange     *pRange,
  [in] TfAnchor     aPos
);

Parameters

[in] ec

Contains an edit cookie that identifies the edit context obtained from ITfDocumentMgr::CreateContext or ITfEditSession::DoEditSession.

[in] pRange

Pointer to an ITfRange interface that contains the anchor that the end anchor is moved to.

[in] aPos

Contains one of the TfAnchor values that specify which anchor of pRange the end anchor will get moved to.

Return value

This method can return one of these values.

Value Description
S_OK
The method was successful.
E_INVALIDARG
pRange is invalid.
E_FAIL
An unspecified error occurred.
TF_E_NOLOCK
The edit context identified by ec does not have a read-only lock.

Remarks

The start and end positions of a range are called anchors.

If the shift operation causes the range end anchor to move past the start anchor, the start anchor is moved to the same location as the end anchor.

This method is more efficient than ITfRange::ShiftEnd and should be used.

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

ITfDocumentMgr::CreateContext

ITfEditSession::DoEditSession

ITfRange

ITfRange::ShiftEnd

ITfRange::ShiftStartToRange