Поделиться через


DragDrop Класс

Определение

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

public ref class DragDrop abstract sealed
public static class DragDrop
type DragDrop = class
Public Class DragDrop
Наследование
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

Возникает непрерывно, пока выполняется операция перетаскивания, и позволяет источнику сброса завершить операцию перетаскивания в зависимости от состояния клавиши или кнопки.

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

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