ITfComposition::ShiftStart Method

Syntax

HRESULT ShiftStart(
  [in]  TfEditCookie ecWrite,
  [in]  ITfRange *pNewStart
);

Parameters

ecWrite [in]

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

pNewStart [in]

Pointer to an ITfRange object that contains the new start anchor position. The start anchor of the context will be moved to the start anchor of this range. This method fails if the start anchor of this range is positioned beyond the end anchor of the composition.

Return Value

The method can return one of the following values.

ValueDescription
S_OK

The method was successful.

E_FAIL

An unspecified error occurred.

E_INVALIDARG

The start anchor of pNewStart is positioned past the end anchor of the composition or pNewStart is invalid.

E_UNEXPECTED

The composition has already terminated.

TF_E_NOLOCK

The edit context identified by ecWrite does not have a read/write lock.

 

Remarks

This method causes the GUID_PROP_COMPOSING property to be removed from any text removed from the composition. Likewise, the GUID_PROP_COMPOSING property will also be added to any text added to the composition.

Requirements

Minimum supported clientWindows 2000 Professional
Minimum supported serverWindows 2000 Server
RedistributableTSF 1.0 onWindows NT 4.0,Windows 2000 ProfessionalandWindows MeWindows 98
HeaderMsctf.idl and Msctf.h
DLLMsctf.dll

See Also

ITfComposition
ITfEditSession::DoEditSession
ITfRange
ITfComposition::ShiftEnd

Send comments about this topic to Microsoft

Build date: 7/14/2009

Tags :


Page view tracker