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
| 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 |
Siehe auch
Konzept
Referenz