IVsHierarchyDropDataSource2.OnBeforeDropNotify(IDataObject, UInt32, Int32) Methode

Definition

Ermöglicht der Quelle des Ziehvorgang zur Speicherung nicht gespeicherter Elemente vor dem Ablegen aufzufordern. Benachrichtigt die Quellhierarchie, dass die Informationen, die davon gezogen werden, im Begriff sind, in einem Ziel abgelegt zu werden. Diese Methode wird aufgerufen, nachdem die Maustaste bei einem Ablegevorgang freigegeben wurde.

public:
 int OnBeforeDropNotify(Microsoft::VisualStudio::OLE::Interop::IDataObject ^ pDataObject, System::UInt32 dwEffect, [Runtime::InteropServices::Out] int % pfCancelDrop);
int OnBeforeDropNotify(Microsoft::VisualStudio::OLE::Interop::IDataObject const & pDataObject, unsigned int dwEffect, [Runtime::InteropServices::Out] int & pfCancelDrop);
public int OnBeforeDropNotify (Microsoft.VisualStudio.OLE.Interop.IDataObject pDataObject, uint dwEffect, out int pfCancelDrop);
abstract member OnBeforeDropNotify : Microsoft.VisualStudio.OLE.Interop.IDataObject * uint32 * int -> int
Public Function OnBeforeDropNotify (pDataObject As IDataObject, dwEffect As UInteger, ByRef pfCancelDrop As Integer) As Integer

Parameter

pDataObject
IDataObject

[in] Zeiger auf die IDataObject-Schnittstelle des gezogenen Elements. Enthält die Daten, die beim Drag & Drop-Vorgang übertragen werden. Wenn das Ablegen geschieht, wird dieses Datenobjekt (Element) in das Hierarchiefenster der neuen Hierarchie integriert.

dwEffect
UInt32

[in] Zeiger auf einen DWORD-Wert, der den Effekt des Ablegevorgangs angibt: DROPEFFECT_COPY, DROPEFFECT_LINK oder DROPEFFECT_MOVE. Die Werte schließen sich gegenseitig aus und können nicht kombiniert werden.

pfCancelDrop
Int32

[out, retval] Wenn true, wurde der Ablegevorgang durch die Quellhierarchie abgebrochen. Wenn false, dann kann der Ablegevorgang fortgesetzt 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:

Aus vsshell. idl:

HRESULT IVsHierarchyDropDataSource2::OnBeforeDropNotify(  
   [in] IDataObject *pDataObject,  
   [in] DWORD dwEffect,  
   [out,retval] BOOL *pfCancelDrop  
);  

Hinweise

Verwenden Sie diese Methode, damit die Datenquellen Hierarchie in einem Drag & Drop-Vorgang auf der Grundlage der Daten und des Schlüssel Zustands einen Drop zulässt oder verweigert. Die Quell Hierarchie kann diese Benachrichtigung auch verwenden, um den Benutzer aufzufordern, die Quelldokumente zu speichern, wenn Sie geändert wurden, bevor Sie an das Ziel übertragen werden.

Gilt für