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

Статья
03/13/2024

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

Синтаксис

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

Параметры

Unit

Тип: long

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

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

Count

Тип: long

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

Extend

Тип: long

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

pDelta

Тип: long*

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

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

Тип: HRESULT

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

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

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

Требования

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