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

Задает конечное положение диапазона.

Синтаксис

HRESULT SetEnd(
  long cpLim
);

Параметры

cpLim

Тип: long

Новая позиция конца.

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

Тип: HRESULT

Метод возвращает значение HRESULT . Если метод завершается успешно, он возвращает S_OK. Если метод завершается сбоем, он возвращает S_FALSE.

Комментарии

Если новая конечная позиция меньше начальной позиции, этот метод также задает начальную позицию cp; то есть диапазон становится точкой вставки.

Если этот диапазон фактически является выделенным, позиция конца становится активной и, если отображение не зависает, оно прокручивается в поле зрения.

ITextRange::SetStart задает начальную позицию диапазона, а ITextRange::SetRange задает оба конца диапазона одновременно. Чтобы преобразовать неразрожденный диапазон ( r) в вырожденный (точка вставки) в начальной позиции, используйте

r.End = r.Start

Аналогичным образом r.Start = r.End преобразует r в точку вставки в конечной позиции.

Чтобы добавить 1 в конечную позицию, если она не находится в конце истории, используйте:

r.End = r.End + 1

Это также делает позицию конца активной и может превратить вырожденный диапазон в неразроженный.

Требования

См. также раздел

Основные понятия

GetEnd

ITextRange

Справочные материалы

SetRange

SetStart

Текстовая объектная модель