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

Статья
03/03/2024

Задает позицию символа для начала этого диапазона.

Синтаксис

HRESULT SetStart(
  [in] long cpFirst
);

Параметры

[in] cpFirst

Тип: long

Новая позиция символа для начала диапазона.

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

Тип: HRESULT

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

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

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

range.End = range.Start

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

В следующем примере 1 добавляется в конечную позицию, если она не находится в конце истории.

range.End = range.End + 1

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

Требования

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