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

Статья
08/26/2023

Возвращает символ в начальной позиции диапазона.

Синтаксис

HRESULT GetChar(
  long *pChar
);

Параметры

pChar

Тип: long*

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

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

Тип: HRESULT

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

Аналогичным образом ITextRange::SetChar перезаписывает символ в начале диапазона указанным символом. Символы, полученные и заданные этими методами, являются переменными LONG , которые скрывают способ их хранения в резервном хранилище (в виде байтов, слов, переменной длины и т. д.), и для них не требуется использование BSTR.

Свойство Char, которое может выполнять большинство действий, которые может выполнять коллекция символов, имеет два больших преимущества:

Он может ссылаться на любой символ в родительской истории, а не ограничиваться родительским диапазоном.
Это значительно быстрее, так как вместо объектов range используются объекты LONG.

Соответственно, текстовая объектная модель (TOM) не поддерживает коллекцию символов.

Требования


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