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

Статья
08/26/2023

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

Синтаксис

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