ITextRange::Cut-Methode (tom.h)

  • Artikel

Schneidet den Nur- oder Rich-Text abhängig vom pVar-Parameter in ein Datenobjekt oder in die Zwischenablage.

Syntax

HRESULT Cut(
  VARIANT *pVar
);

Parameter

pVar

Typ: VARIANT*

Der ausgeschnittene Text. pVar-ppunkVal> ist der out-Parameter für ein IDataObject-Objekt, 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 einer der folgenden Werte zurückgegeben. Weitere Informationen zu COM-Fehlercodes finden Sie unter Fehlerbehandlung in COM.

Rückgabecode Beschreibung
E_ACCESSDENIED
 Text ist schreibgeschützt.
E_OUTOFMEMORY
 Nicht genügend Arbeitsspeicher.

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

ITextRange

Referenz

Textobjektmodell