IVsUIHierWinClipboardHelper.Paste(IDataObject, UInt32) Methode

Definition

Fügt ein Datenobjekt aus der Zwischenablage in die Hierarchie ein.

public:
 int Paste(Microsoft::VisualStudio::OLE::Interop::IDataObject ^ pDataObject, System::UInt32 dwEffects);
public:
 int Paste(Microsoft::VisualStudio::OLE::Interop::IDataObject ^ pDataObject, unsigned int dwEffects);
int Paste(Microsoft::VisualStudio::OLE::Interop::IDataObject const & pDataObject, unsigned int dwEffects);
public int Paste (Microsoft.VisualStudio.OLE.Interop.IDataObject pDataObject, uint dwEffects);
abstract member Paste : Microsoft.VisualStudio.OLE.Interop.IDataObject * uint32 -> int
Public Function Paste (pDataObject As IDataObject, dwEffects As UInteger) As Integer

Parameter

pDataObject
IDataObject

[in] Zeiger auf die IDataObject-Schnittstelle des Elements, das eingefügt wird. Dieses Datenobjekt enthält die Daten, die im Einfügevorgang übertragen werden. Wenn das Einfügen geschieht, wird dieses Datenobjekt (Hierarchieelement) in die Zielhierarchie integriert.

dwEffects
UInt32

in Ein Zeiger auf den Wert des- pdwEffect Parameters des- IVsHierarchy Objekts, mit dem alle von der Hierarchie unterstützten Effekte identifiziert werden.

Gibt zurück

Int32

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Bei einem Fehler wird ein Fehlercode zurückgegeben.

Hinweise

COM-Signatur

Aus vsshell. idl:

HRESULT IVsUIHierWinClipboardHelper::Paste(  
   [in] IDataObject *pDataObject,  
   [in] DWORD dwEffects  
);  

Wenn ein Einfüge Vorgang in der Ziel Hierarchie erfolgt, empfängt die Quell Hierarchie eine Einfüge Benachrichtigung aus der Umgebung über die- OnPaste Methode.

Drop Effects ist im dwEffect -Parameter enthalten und beschreibt die Aktion, die einem Drop-Vorgang zugeordnet ist. In der folgenden Tabelle werden mögliche dwEffect Werte und ihre Beschreibungen angezeigt:

Hinweis

Diese Effekte sind exklusiv und können nicht mit dem bitweisen OR-Operator kombiniert werden.

Effekt Name Wert1 Beschreibung
DROPEFFECT_NONE 0 Das Ablage Ziel (Hierarchie Fenster) kann die Daten nicht akzeptieren. Es ist kein Drop zulässig.
DROPEFFECT_COPY 1 Das gelöschte Element bleibt in der Quelle, und eine Kopie davon wird dem Ziel hinzugefügt.
DROPEFFECT_MOVE 2 Das gelöschte Element wurde dem Ziel hinzugefügt. Das Element wird aus der Quelle entfernt, und sein Speicher wird gelöscht.
DROPEFFECT_LINK 4 Dem Ziel wird ein Link zum Quell Element hinzugefügt, sodass das Element aus der Quelle entfernt werden soll, der Speicher jedoch beibehalten werden muss, damit der Link nicht beschädigt wird. Ein Link ist daher ein Sonderfall von Move.
  1. Die Werte des- dwEffects Parameters stammen aus der- DROPEFFECT Enumeration in der MSDN Library Platform SDK-Dokumentation.

Gilt für