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

Статья
08/26/2023

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

Синтаксис

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

Параметры

Cset

Тип: VARIANT*

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

Count

Тип: long

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

pDelta

Тип: long*

Фактическое число символов в начале диапазона перемещается, плюс 1 для совпадения, если значение count больше нуля, и –1 для совпадения, если значение Count меньше нуля. Значение может быть равно NULL.

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

Тип: HRESULT

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

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

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

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

Требования

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