IVsHierarchyDropDataSource2.OnBeforeDropNotify(IDataObject, UInt32, Int32) Метод

Определение

Разрешает источнику перетаскивания запрашивать сохранение несохраненных элементов перед добавлением. Уведомляет исходную иерархию о том, что извлеченная из нее информация скоро будет размещена в целевом объекте. Этот метод вызывается сразу после отпускании кнопки мыши при перетаскивании.

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

Параметры

pDataObject
IDataObject

[in] Указатель на интерфейс IDataObject в перетащенном элементе. Содержит данные, передаваемые в операцию перетаскивания. Если выполняется перетаскивание, этот объект данных (элемент) встраивается в окно иерархии новой иерархии.

dwEffect
UInt32

[in] Указатель на значение DWORD, указывающее последствия перетаскивания: DROPEFFECT_COPY, DROPEFFECT_LINK или DROPEFFECT_MOVE. Значения являются взаимоисключающими и не могут сочетаться.

pfCancelDrop
Int32

[out, retval] Если имеет значение true, то иерархия источника отменила перетаскивание. Если false, перетаскивание может быть продолжен.

Возвращаемое значение

Int32

Если метод завершается успешно, возвращает значение S_OK. В противном случае функция возвращает код ошибки.

Комментарии

Подпись COM

Из всшелл. IDL:

Из всшелл. IDL:

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

Примечания

Используйте этот метод, чтобы разрешить иерархии источников данных в операции перетаскивания разрешать или запрещать перетаскивание на основе данных и состояния ключа. Исходная иерархия также может использовать это уведомление, чтобы попросить пользователя сохранить исходные документы, если они являются «грязными», перед передачей их в целевой объект.

Применяется к