Метод ITextSelection::TypeText (tom.h)

Вводит строку, заданную bstr при этом выборе, как если бы кто-то ввел ее. Этот метод аналогичен базовому методу SetText , но учитывает состояние ключа вставки и замены и параметры пользовательского интерфейса, такие как автозамена и смарт-кавычки.

Синтаксис

HRESULT TypeText(
  BSTR bstr
);

Параметры

bstr

Тип: BSTR

Строка для ввода в этот выделенный фрагмент.

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

Тип: HRESULT

Метод возвращает значение HRESULT . Если метод завершается успешно, он возвращает S_OK. Если метод завершается ошибкой, он возвращает один из следующих кодов ошибок. Дополнительные сведения о кодах ошибок COM см. в разделе Обработка ошибок в COM.

Комментарии

Этот метод вводит строку, заданную bstr при выборе, так, как если бы кто-то ввел ее. Использование TypeText выполняется быстрее, чем отправка символов через функцию SendMessage , но медленнее, чем при использовании SetText.

TypeText похож на базовый метод SetText , однако он учитывает состояние ключа Insert/Overtype и параметры пользовательского интерфейса, такие как автозамена и смарт-кавычки. Например, он удаляет все неродные выделенные фрагменты, а затем вставляет или overtypes (в зависимости от состояния ключа Insert/Overtype — см. метод SetFlags ) строку bstr в точке вставки, оставляя этот фрагмент в качестве точки вставки после вставленного текста.

Требования

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

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

ITextSelection

Другие ресурсы

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

SendMessage

SetFlags

Settext

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