Метод ITfRange::ShiftStart (msctf.h)

Статья
08/24/2023

Перемещает начальную привязку диапазона.

Синтаксис

HRESULT ShiftStart(
  [in]  TfEditCookie      ec,
  [in]  LONG              cchReq,
  [out] LONG              *pcch,
  [in]  const TF_HALTCOND *pHalt
);

Параметры

[in] ec

Содержит файл cookie редактирования, определяющий контекст редактирования. Он получен из ITfDocumentMgr::CreateContext или ITfEditSession::D oEditSession.

[in] cchReq

Содержит число символов, в которых смещена начальная привязка. Отрицательное значение приводит к тому, что привязка перемещается назад, а положительное значение приводит к тому, что привязка будет двигаться вперед.

[out] pcch

Указатель на значение LONG , которое получает количество символов, в которых была смещена привязка.

[in] pHalt

Указатель на структуру TF_HALTCOND , содержащую условия смещения. Этот параметр является необязательным и может иметь значение NULL.

Возвращаемое значение

Этот метод может возвращать одно из этих значений.

Значение	Описание
S_OK	Метод выполнен успешно.
E_INVALIDARG	Один или несколько параметров недопустимы.
E_FAIL	Произошла неизвестная ошибка.
TF_E_NOLOCK	Контекст редактирования, определенный ec , не имеет блокировки только для чтения.

Этот метод не может переместить привязку за границу области. Если сдвиг достигает границы области, количество фактически смещенных символов будет меньше запрошенного. ITfRange::ShiftStartRegion используется для перемещения привязки в смежную область.

Если операция сдвига приводит к тому, что начальная привязка диапазона перемещается за пределы конечной привязки, конечная привязка перемещается в то же расположение, что и начальная привязка.

ITfRange::ShiftStart может быть длительной операцией. Для повышения производительности по возможности используйте ITfRange::ShiftStartToRange .

Требования


Минимальная версия клиента	Windows 2000 Профессиональная [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows 2000 Server [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	msctf.h
DLL	Msctf.dll
Распространяемые компоненты	TSF 1.0 в Windows 2000 Professional