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

Статья
08/24/2023

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

Синтаксис

HRESULT ShiftEnd(
  [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_FAIL	Произошла неизвестная ошибка.
E_INVALIDARG	Один или несколько параметров являются недопустимыми.
TF_E_NOLOCK	Контекст редактирования, определяемый ec , не имеет блокировки только для чтения.

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

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

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

Требования


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