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

Статья
08/26/2023

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

Синтаксис

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

Параметры

Cset

Тип: VARIANT*

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

Count

Тип: long

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

pDelta

Тип: long*

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

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

Тип: HRESULT

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

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

Если ни один символ из набора, заданного параметром Cset , не найден в позиции Count конца диапазона, диапазон остается без изменений. Если новый конец предшествует старому началу, новое начало будет равно новому концу.

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

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

Требования

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