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

Статья
03/03/2024

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

Синтаксис

HRESULT TypeText(
  BSTR bstr
);

Параметры

bstr

Тип: BSTR

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

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

Тип: HRESULT

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

Код возврата	Описание
E_ACCESSDENIED	Текст защищен от записи.
E_INVALIDARG	bstr имеет значение NULL.
E_OUTOFMEMORY	Недостаточно памяти.

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

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

Требования

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