ITextRange::Copy-Methode (tom.h)

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

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

Siehe auch

Konzept

Ausschneiden

GetFormattedText

GetText

ITextRange

Einfügen

Referenz

SetFormattedText

Settext

Textobjektmodell