Поделиться через


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

Копирует текст в объект данных.

Синтаксис

HRESULT Copy(
  VARIANT *pVar
);

Параметры

pVar

Тип: VARIANT*

Скопированный текст. pVar-ppunkVal> — это параметр out для IDataObject при условии, что существуют следующие условия:

  • pVar-vt> = (VT_UNKNOWN | VT_BYREF)
  • Значение pVar не равно NULL
  • pVar-ppunkVal> не имеет значения NULL
В противном случае используется буфер обмена.

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

Тип: HRESULT

Этот метод возвращает значение HRESULT . В случае успешного выполнения возвращается S_OK. В противном случае возвращается E_OUTOFMEMORY.

Комментарии

Методы ITextRange::Cut, ITextRange::Copy и ITextRange::P aste позволяют выполнять обычные операции Вырезания, Копирования и Вставки для объекта диапазона с помощью IDataObject, тем самым не изменяя содержимое буфера обмена. К числу поддерживаемых форматов буфера обмена обычно относятся CF_TEXT и CF_RTF. Кроме того, закрытые форматы буфера обмена можно использовать для ссылки на собственные внутренние форматы форматов форматированного текста в текстовом решении.

Для копирования и замены обычного текста можно использовать методы ITextRange::GetText и ITextRange::SetText . Чтобы скопировать форматированный текст из диапазона r1 в диапазон r2 без использования буфера обмена, можно использовать методы Copy и Paste , а также методы ITextRange::GetFormattedText и ITextRange::SetFormattedText , как показано в следующем примере Microsoft Visual Basic:

r2.GetFormattedText = r1.GetFormattedText

Требования

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

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

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

Вырезать

GetFormattedText

Gettext

ITextRange

Вставить

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

SetFormattedText

Settext

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