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, перетаскивание может быть продолжен.
Возвращаемое значение
Если метод завершается успешно, возвращает значение S_OK. В противном случае функция возвращает код ошибки.
Комментарии
Подпись COM
Из всшелл. IDL:
Из всшелл. IDL:
HRESULT IVsHierarchyDropDataSource2::OnBeforeDropNotify(
[in] IDataObject *pDataObject,
[in] DWORD dwEffect,
[out,retval] BOOL *pfCancelDrop
);
Примечания
Используйте этот метод, чтобы разрешить иерархии источников данных в операции перетаскивания разрешать или запрещать перетаскивание на основе данных и состояния ключа. Исходная иерархия также может использовать это уведомление, чтобы попросить пользователя сохранить исходные документы, если они являются «грязными», перед передачей их в целевой объект.