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

Задает текст в этом диапазоне.

Синтаксис

HRESULT SetText(
  [in] BSTR bstr
);

Параметры

[in] bstr

Тип: BSTR

Текст, заменяющий текущий текст в этом диапазоне. Если значение null, текущий текст удаляется.

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

Тип: HRESULT

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

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

Комментарии

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

Если после вызова ITextRange::SetText вы вызываете ITextRange::GetText, вы получите тот же текст, который вы задали с помощью метода ITextRange::SetText (если только другой диапазон не изменил этот текст между вызовами).

Требования

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

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

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

Gettext

ITextRange

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

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

TypeText

  • Last updated on