Метод ITextRange::MoveEnd (tom.h)

Статья
03/13/2024

Перемещение конечной позиции диапазона.

Синтаксис

HRESULT MoveEnd(
  long Unit,
  long Count,
  long *pDelta
);

Параметры

Unit

Тип: long

Единицы измерения, на которые перемещается конец диапазона. Значение по умолчанию — tomCharacter. Список других значений единиц см. в разделе ITextRange.

Count

Тип: long

Количество единиц для перемещения. Значение по умолчанию — 1. Если значение Count больше нуля, движение вперед —к концу истории, а если count меньше нуля, то движение назад — к началу. Если значение Count равно нулю, конечная позиция не изменяется.

pDelta

Тип: long*

Фактическое число единиц, за которым перемещается конечная позиция диапазона. Значение может быть равно NULL.

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

Тип: HRESULT

Метод возвращает значение HRESULT . Если метод завершается успешно, он возвращает S_OK. Если метод завершается сбоем, он возвращает один из следующих кодов ошибок. Дополнительные сведения о кодах ошибок COM см. в разделе Обработка ошибок в COM.

Код возврата	Описание
E_NOTIMPL	Единица измерения не поддерживается.
S_FALSE	Сбой по какой-то другой причине.

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

Движение, описанное в ITextRange::MoveEnd , является логическим, а не геометрическим. То есть движение к концу или к началу истории. В зависимости от языка переход к концу истории может быть перемещением влево или вправо.

Дополнительные сведения см. в разделах ITextRange и ITextRange::Move.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	tom.h
DLL	Msftedit.dll