DragDrop Класс

Ссылка

Определение

Пространство имен:: System.Windows

Сборка:: PresentationCore.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Предоставляет вспомогательные методы и поля для инициирования операций перетаскивания, включая метод для начала операции перетаскивания и средства добавления и удаления связанных с перетаскиванием обработчиков событий.

public ref class DragDrop abstract sealed

public static class DragDrop

type DragDrop = class

Public Class DragDrop

Наследование: Object
DragDrop

Перетаскивание обычно относится к методу передачи данных, который включает использование мыши (или другого указывающего устройства) для выбора одного или нескольких объектов, перетаскивание этих объектов на нужный целевой объект в пользовательском интерфейсе и их удаление. Операция перетаскивания аналогична операции копирования (или вырезания) и вставки, которая используется для передачи данных из одного объекта или приложения в другой. Операции перетаскивания обычно включают две стороны: источник перетаскивания, из которого происходят перетаскиваемые данные, и целевой объект перетаскивания, который получает удаленные данные. События и методы, необходимые для операций перетаскивания, определяются в классе DragDrop. События перетаскивания являются присоединенными событиями, которые можно присоединить к любому UIElement объекту или ContentElement. Источник перетаскивания и целевой объект перетаскивания могут быть элементами пользовательского интерфейса в том же приложении или в разных приложениях. Однако целевой объект удаления должен знать, как обрабатывать данные, передаваемые источником перетаскивания.

Примечание

UIElement Классы и ContentElement содержат псевдонимы для событий перетаскивания, чтобы события отображались в списке членов классов, когда эти классы наследуются в качестве базового класса. При присоединении обработчика событий к событию перетаскивания в одном из этих классов обработчик присоединяется к базовому DragDrop событию и получает тот же экземпляр данных события. Пример см. в разделе UIElement.Drop.

Источник перетаскивания инициирует операцию перетаскивания путем вызова статического метода DoDragDrop и передачи в него передаваемых данных. Элемент обычно обрабатывает следующие события, когда он является источником перетаскивания:

Элемент обычно обрабатывает следующие события, когда он является целевым объектом удаления:

Дополнительные сведения и примеры см. в разделе Общие сведения о перетаскивании.

Поля

DragEnterEvent	Идентифицирует присоединенное событие DragEnter.
DragLeaveEvent	Идентифицирует присоединенное событие DragLeave.
DragOverEvent	Идентифицирует присоединенное событие DragOver.
DropEvent	Идентифицирует присоединенное событие Drop.
GiveFeedbackEvent	Идентифицирует присоединенное событие GiveFeedback.
PreviewDragEnterEvent	Идентифицирует присоединенное событие PreviewDragEnter.
PreviewDragLeaveEvent	Идентифицирует присоединенное событие PreviewDragLeave.
PreviewDragOverEvent	Идентифицирует присоединенное событие PreviewDragOver.
PreviewDropEvent	Идентифицирует присоединенное событие PreviewDrop.
PreviewGiveFeedbackEvent	Идентифицирует присоединенное событие PreviewGiveFeedback.
PreviewQueryContinueDragEvent	Идентифицирует присоединенное событие PreviewQueryContinueDrag.
QueryContinueDragEvent	Идентифицирует присоединенное событие QueryContinueDrag.

Методы

AddDragEnterHandler(DependencyObject, DragEventHandler)	Добавляет обработчик событий DragEnter к заданному объекту зависимости.
AddDragLeaveHandler(DependencyObject, DragEventHandler)	Добавляет обработчик событий DragLeave к заданному объекту зависимости.
AddDragOverHandler(DependencyObject, DragEventHandler)	Добавляет обработчик событий DragOver к заданному объекту зависимости.
AddDropHandler(DependencyObject, DragEventHandler)	Добавляет обработчик событий Drop к заданному объекту зависимости.
AddGiveFeedbackHandler(DependencyObject, GiveFeedbackEventHandler)	Добавляет обработчик событий GiveFeedback к заданному объекту зависимости.
AddPreviewDragEnterHandler(DependencyObject, DragEventHandler)	Добавляет обработчик событий PreviewDragEnter к заданному объекту зависимости.
AddPreviewDragLeaveHandler(DependencyObject, DragEventHandler)	Добавляет обработчик событий PreviewDragLeave к заданному объекту зависимости.
AddPreviewDragOverHandler(DependencyObject, DragEventHandler)	Добавляет обработчик событий PreviewDragOver к заданному объекту зависимости.
AddPreviewDropHandler(DependencyObject, DragEventHandler)	Добавляет обработчик событий PreviewDrop к заданному объекту зависимости.
AddPreviewGiveFeedbackHandler(DependencyObject, GiveFeedbackEventHandler)	Добавляет обработчик событий PreviewGiveFeedback к заданному объекту зависимости.
AddPreviewQueryContinueDragHandler(DependencyObject, QueryContinueDragEventHandler)	Добавляет обработчик событий PreviewQueryContinueDrag к заданному объекту зависимости.
AddQueryContinueDragHandler(DependencyObject, QueryContinueDragEventHandler)	Добавляет обработчик событий QueryContinueDrag к заданному объекту зависимости.
DoDragDrop(DependencyObject, Object, DragDropEffects)	Инициирует операцию перетаскивания.
RemoveDragEnterHandler(DependencyObject, DragEventHandler)	Удаляет обработчик событий DragEnter из заданного объекта зависимости.
RemoveDragLeaveHandler(DependencyObject, DragEventHandler)	Удаляет обработчик событий DragLeave из заданного объекта зависимости.
RemoveDragOverHandler(DependencyObject, DragEventHandler)	Удаляет обработчик событий DragOver из заданного объекта зависимости.
RemoveDropHandler(DependencyObject, DragEventHandler)	Удаляет обработчик событий Drop из заданного объекта зависимости.
RemoveGiveFeedbackHandler(DependencyObject, GiveFeedbackEventHandler)	Удаляет обработчик событий GiveFeedback из заданного объекта зависимости.
RemovePreviewDragEnterHandler(DependencyObject, DragEventHandler)	Удаляет обработчик событий PreviewDragEnter из заданного объекта зависимости.
RemovePreviewDragLeaveHandler(DependencyObject, DragEventHandler)	Удаляет обработчик событий PreviewDragLeave из заданного объекта зависимости.
RemovePreviewDragOverHandler(DependencyObject, DragEventHandler)	Удаляет обработчик событий PreviewDragOver из заданного объекта зависимости.
RemovePreviewDropHandler(DependencyObject, DragEventHandler)	Удаляет обработчик событий PreviewDrop из заданного объекта зависимости.
RemovePreviewGiveFeedbackHandler(DependencyObject, GiveFeedbackEventHandler)	Удаляет обработчик событий PreviewGiveFeedback из заданного объекта зависимости.
RemovePreviewQueryContinueDragHandler(DependencyObject, QueryContinueDragEventHandler)	Удаляет обработчик событий PreviewQueryContinueDrag из заданного объекта зависимости.
RemoveQueryContinueDragHandler(DependencyObject, QueryContinueDragEventHandler)	Удаляет обработчик событий QueryContinueDrag из заданного объекта зависимости.

Присоединенные события

DragEnter	Возникает при перетаскивании объекта в границы элемента, выступающего в качестве конечного расположения сброса.
DragLeave	Возникает при перетаскивании объекта за пределы границ элемента, выступающего в качестве места переноса, без отпускания объекта.
DragOver	Возникает постоянно при перетаскивании объекта в границах элемента, выступающего в качестве цели перетаскивания.
Drop	Возникает при помещении объекта в границах элемента, выступающего в качестве цели перетаскивания.
GiveFeedback	Возникает постоянно во время операции перетаскивания и позволяет источнику перетаскивания предоставлять пользователю сведения о взаимодействии.
PreviewDragEnter	Возникает при перетаскивании объекта в границы элемента, выступающего в качестве конечного расположения сброса.
PreviewDragLeave	Возникает при перетаскивании объекта за пределы границ элемента, выступающего в качестве места переноса, без отпускания объекта.
PreviewDragOver	Возникает постоянно при перетаскивании объекта в границах элемента, выступающего в качестве цели перетаскивания.
PreviewDrop	Возникает при помещении объекта в границах элемента, выступающего в качестве цели перетаскивания.
PreviewGiveFeedback	Возникает постоянно во время операции перетаскивания и позволяет источнику перетаскивания предоставлять пользователю сведения о взаимодействии.
PreviewQueryContinueDrag	Возникает непрерывно, пока выполняется операция перетаскивания, и позволяет источнику сброса завершить операцию перетаскивания в зависимости от состояния клавиши или кнопки.
QueryContinueDrag	Возникает непрерывно, пока выполняется операция перетаскивания, и позволяет источнику сброса завершить операцию перетаскивания в зависимости от состояния клавиши или кнопки.

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

См. также раздел

DataObject