ITextRange::Copy-Methode (tom.h)

Artikel
08/26/2023

Kopiert den Text in ein Datenobjekt.

Syntax

HRESULT Copy(
  VARIANT *pVar
);

Parameter

pVar

Typ: VARIANT*

Der kopierte Text. pVar-ppunkVal> ist der out-Parameter für ein IDataObject, sofern die folgenden Bedingungen vorhanden sind:

pVar-vt> = (VT_UNKNOWN | VT_BYREF)
pVar ist nicht NULL
pVar-ppunkVal> ist nicht NULL

Andernfalls wird die Zwischenablage verwendet.

Rückgabewert

Typ: HRESULT

Diese Methode gibt einen HRESULT-Wert zurück. Bei erfolgreicher Ausführung wird S_OK zurückgegeben. Andernfalls wird E_OUTOFMEMORY zurückgegeben.

Hinweise

Mit den Methoden ITextRange::Cut, ITextRange::Copy und ITextRange::P aste können Sie die üblichen Cut-, Copy- und Paste-Vorgänge für ein Bereichsobjekt mithilfe eines IDataObject ausführen, wodurch der Inhalt der Zwischenablage nicht geändert wird. Zu den in der Regel unterstützten Formaten der Zwischenablage gehören CF_TEXT und CF_RTF. Darüber hinaus können private Zwischenablageformate verwendet werden, um auf die internen Rich-Text-Formate einer Textlösung zu verweisen.

Zum Kopieren und Ersetzen von Nur-Text können Sie die Methoden ITextRange::GetText und ITextRange::SetText verwenden. Um formatierten Text aus dem Bereich r1 in den Bereich r2 zu kopieren, ohne die Zwischenablage zu verwenden, können Sie Copy und Paste sowie die Methoden ITextRange::GetFormattedText und ITextRange::SetFormattedText verwenden, wie im folgenden Microsoft Visual Basic-Beispiel gezeigt:

r2.GetFormattedText = r1.GetFormattedText

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	tom.h
DLL	Msftedit.dll