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

Статья
08/26/2023

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

Синтаксис

HRESULT MoveStartWhile(
  VARIANT *Cset,
  long    Count,
  long    *pDelta
);

Параметры

Cset

Тип: VARIANT*

Набор символов, используемый в сопоставлении. Это может быть явная строка символов или индекс набора символов. Дополнительные сведения см. в разделе Наборы совпадений символов.

Count

Тип: long

Максимальное число символов для перемещения. Значение по умолчанию — tomForward, которое выполняет поиск до конца истории. Если значение Count больше нуля, поиск выполняется вперед (в конце истории), а если значение Count меньше нуля, поиск выполняется в обратном направлении к началу. Если значение Count равно нулю, начальная позиция не изменяется.

pDelta

Тип: long*

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

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

Тип: HRESULT

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

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

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

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

Требования

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