Поделиться через


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

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

Синтаксис

HRESULT GetChar(
  long *pChar
);

Параметры

pChar

Тип: long*

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

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

Тип: HRESULT

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

Комментарии

В следующем примере Microsoft Visual Basic задается значение ch , равное символу в начале диапазона.

ch = r.Char

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

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

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

Требования

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

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

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

ITextRange

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

SetChar

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