Метод ITextSelection::MoveUp (tom.h)

Статья
03/03/2024

Имитирует функциональные возможности клавиш СТРЕЛКА ВВЕРХ и PAGE UP.

Синтаксис

HRESULT MoveUp(
  long Unit,
  long Count,
  long Extend,
  long *pDelta
);

Параметры

Unit

Тип: long

Единица измерения, используемая в операции. Это может быть один из следующих вариантов.

Значение	Соответствующая комбинация клавиш	Значение
tomLine	Стрелка вверх	Перемещается вверх на одну строку. Это значение по умолчанию.
tomParagraph	Ctrl+СТРЕЛКА ВВЕРХ	Перемещает вверх на один абзац.
tomScreen	PAGE UP	Перемещает вверх на один экран.
tomWindow	Ctrl+Page Up	Перемещается к первому символу в окне.

Count

Тип: long

Число единиц для перемещения. Значение по умолчанию — 1.

Extend

Тип: long

Флаг, указывающий, как изменить выделенный фрагмент. Если значение Extend равно нулю (или tomMove), метод сворачивает выделение до точки вставки, а затем перемещается. Если параметр Extend имеет значение 1 (или tomExtend), метод перемещает активный конец и оставляет другой конец в покое. Значение по умолчанию равно нулю. Ненулевое значение Extend соответствует нажатию клавиши SHIFT в дополнение к сочетанию клавиш, описанной в разделе Единица измерения.

pDelta

Тип: long*

Фактическое количество единиц, в которые перемещается точка вставки или активный конец. Этот параметр может быть нулевым. Свертывание выделенного фрагмента считается одной единицей.

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

Тип: HRESULT

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

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

Методы MoveUp и MoveDown похожи на методы MoveLeft и MoveRight , за исключением того, что они отражают поведение клавиш СТРЕЛКА ВВЕРХ, СТРЕЛКА ВНИЗ, СТРАНИЦА ВВЕРХ и СТРАНИЦА ВНИЗ на клавиатуре курсора.

Требования

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