Метод 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.
Требования
Минимальная версия клиента | Windows Vista [только классические приложения] |
Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
Целевая платформа | Windows |
Header | tom.h |
DLL | Msftedit.dll |
См. также раздел
Основные понятия
Справочные материалы