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

Статья
08/26/2023

Перемещает конец диапазона в начало первой перекрывающейся единицы в диапазоне.

Синтаксис

HRESULT StartOf(
  long Unit,
  long Extend,
  long *pDelta
);

Параметры

Unit

Тип: long

Единица измерения, используемая в операции перемещения. Список значений unit см. в обсуждении в разделе ITextRange.

Extend

Тип: long

Перемещение концов диапазона. Может быть одним из указанных далее.

0 (или tomMove)	Свертывание неразрожденного диапазона до начальной позиции путем перемещения точки вставки. Это значение по умолчанию.
1 (или tomExtend)	Перемещает начальную позицию в начало перекрывающейся единицы. Не перемещает конечную позицию.

pDelta

Тип: long*

Указатель на переменную, которая получает количество символов, в которых перемещается начальная позиция. Может принимать значение NULL. При возвращении pDelta — это число знаков со знаком, которое перемещается точка вставки или начальная позиция. Это значение всегда меньше или равно нулю, так как движение всегда к началу истории.

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

Тип: HRESULT

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

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

Методы ITextRange::StartOf и ITextRange::EndOf отличаются от методов HomeKey и EndKey тем, что последние расширяются от активного конца, тогда как ITextRange::StartOf расширяется с начальной позиции, а ITextRange::EndOf расширяется с конечной позиции.

Требования

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