DragDrop DragDrop DragDrop DragDrop Class

Определение

Предоставляет вспомогательные методы и поля для инициирования операций перетаскивания, включая метод для начала операции перетаскивания и средства добавления и удаления связанных с перетаскиванием обработчиков событий.Provides helper methods and fields for initiating drag-and-drop operations, including a method to begin a drag-and-drop operation, and facilities for adding and removing drag-and-drop related event handlers.

public ref class DragDrop abstract sealed
public static class DragDrop
type DragDrop = class
Public Class DragDrop
Наследование
DragDropDragDropDragDropDragDrop

Комментарии

Перетаскиванием обычно называют метод передачи данных, который реализуется с помощью мыши (или другого указывающего устройства) для выбора одного или нескольких объектов и перетаскивания их в цель перетаскивания в пользовательский интерфейсuser interface (UI).Drag-and-drop commonly refers to a method of data transfer that involves using a mouse (or some other pointing device) to select one or more objects, dragging these objects over some desired drop target in the пользовательский интерфейсuser interface (UI), and dropping them. Операция перетаскивания аналогична операции копирования (или вырезания), которая используется для переноса данных из одного объекта или приложения в другое.A drag-and-drop operation is analogous to a copy (or cut)-and-paste operation that is used to transfer data from one object or application to another. Операции перетаскивания обычно используют две стороны: источник перетаскивания, из которого происходят перетаскиваемые данные, и объект перетаскивания, который получает удаленные данные.Drag-and-drop operations typically involve two parties: a drag source from which the dragged data originates and a drop target which receives the dropped data. События и методы, необходимые для операций перетаскивания, определяются в классе DragDrop.The events and methods required for drag-and-drop operations are defined in the DragDrop class. События перетаскивания являются присоединенными событиями, которые могут быть присоединены к любому UIElement или ContentElement.The drag-and-drop events are attached events that can be attached to any UIElement or ContentElement. Источник перетаскивания и цель перетаскивания могут быть элементами пользовательского интерфейса в одном приложении или в разных приложениях.The drag source and drop target may be UI elements in the same application or in different applications. Однако цель перетаскивания должна уметь обрабатывать данные, передаваемые источником перетаскивания.However, the drop target must know how to process the data being passed by the drag source.

Примечание

Классы UIElement иContentElement содержат псевдонимы для событий перетаскивания, чтобы события отображались в списке члены класса, если эти классы унаследованы как базовый класс.The UIElement and ContentElement classes contain aliases for the drag-and-drop events so that the events appear in the class members list when these classes are inherited as a base class. При присоединении обработчика событий к событию перетаскивания в одном из этих классов обработчик прикрепляется к базовому DragDrop событию и получает один и тот же экземпляр данных события.When you attach an event handler to a drag-and-drop event on one of these classes, the handler is attached to the underlying DragDrop event and they receive the same instance of event data. Пример см. в разделе UIElement.Drop.For example, see UIElement.Drop.

Источник перетаскивания инициирует операцию перетаскивания путем вызова статического метода DoDragDrop и передачи в него передаваемых данных.The drag source initiates a drag-and-drop operation by calling the static DoDragDrop method and passing the transferred data to it. Элемент обычно обрабатывает следующие события, когда это источник перетаскивания:An element typically handles the following events when it is a drag source:

Элемент обычно обрабатывает следующие события, когда это цель перетаскивания:An element typically handles the following events when it is a drop target:

Дополнительные сведения и примеры см. в разделе Общие сведения о перетаскивании.For more information and examples, see Drag and Drop Overview.

Поля

DragEnterEvent DragEnterEvent DragEnterEvent DragEnterEvent

Идентифицирует присоединенное событие DragEnter.Identifies the DragEnter attached event.

DragLeaveEvent DragLeaveEvent DragLeaveEvent DragLeaveEvent

Идентифицирует присоединенное событие DragLeave.Identifies the DragLeave attached event

DragOverEvent DragOverEvent DragOverEvent DragOverEvent

Идентифицирует присоединенное событие DragOver.Identifies the DragOver attached event

DropEvent DropEvent DropEvent DropEvent

Идентифицирует присоединенное событие Drop.Identifies the Drop attached event

GiveFeedbackEvent GiveFeedbackEvent GiveFeedbackEvent GiveFeedbackEvent

Идентифицирует присоединенное событие GiveFeedback.Identifies the GiveFeedback attached event

PreviewDragEnterEvent PreviewDragEnterEvent PreviewDragEnterEvent PreviewDragEnterEvent

Идентифицирует присоединенное событие PreviewDragEnter.Identifies the PreviewDragEnter attached event

PreviewDragLeaveEvent PreviewDragLeaveEvent PreviewDragLeaveEvent PreviewDragLeaveEvent

Идентифицирует присоединенное событие PreviewDragLeave.Identifies the PreviewDragLeave attached event

PreviewDragOverEvent PreviewDragOverEvent PreviewDragOverEvent PreviewDragOverEvent

Идентифицирует присоединенное событие PreviewDragOver.Identifies the PreviewDragOver attached event

PreviewDropEvent PreviewDropEvent PreviewDropEvent PreviewDropEvent

Идентифицирует присоединенное событие PreviewDrop.Identifies the PreviewDrop attached event

PreviewGiveFeedbackEvent PreviewGiveFeedbackEvent PreviewGiveFeedbackEvent PreviewGiveFeedbackEvent

Идентифицирует присоединенное событие PreviewGiveFeedback.Identifies the PreviewGiveFeedback attached event

PreviewQueryContinueDragEvent PreviewQueryContinueDragEvent PreviewQueryContinueDragEvent PreviewQueryContinueDragEvent

Идентифицирует присоединенное событие PreviewQueryContinueDrag.Identifies the PreviewQueryContinueDrag attached event

QueryContinueDragEvent QueryContinueDragEvent QueryContinueDragEvent QueryContinueDragEvent

Идентифицирует присоединенное событие QueryContinueDrag.Identifies the QueryContinueDrag attached event

Методы

AddDragEnterHandler(DependencyObject, DragEventHandler) AddDragEnterHandler(DependencyObject, DragEventHandler) AddDragEnterHandler(DependencyObject, DragEventHandler) AddDragEnterHandler(DependencyObject, DragEventHandler)

Добавляет обработчик событий DragEnter к заданному объекту зависимости.Adds a DragEnter event handler to a specified dependency object.

AddDragLeaveHandler(DependencyObject, DragEventHandler) AddDragLeaveHandler(DependencyObject, DragEventHandler) AddDragLeaveHandler(DependencyObject, DragEventHandler) AddDragLeaveHandler(DependencyObject, DragEventHandler)

Добавляет обработчик событий DragLeave к заданному объекту зависимости.Adds a DragLeave event handler to a specified dependency object.

AddDragOverHandler(DependencyObject, DragEventHandler) AddDragOverHandler(DependencyObject, DragEventHandler) AddDragOverHandler(DependencyObject, DragEventHandler) AddDragOverHandler(DependencyObject, DragEventHandler)

Добавляет обработчик событий DragOver к заданному объекту зависимости.Adds a DragOver event handler to a specified dependency object.

AddDropHandler(DependencyObject, DragEventHandler) AddDropHandler(DependencyObject, DragEventHandler) AddDropHandler(DependencyObject, DragEventHandler) AddDropHandler(DependencyObject, DragEventHandler)

Добавляет обработчик событий Drop к заданному объекту зависимости.Adds a Drop event handler to a specified dependency object.

AddGiveFeedbackHandler(DependencyObject, GiveFeedbackEventHandler) AddGiveFeedbackHandler(DependencyObject, GiveFeedbackEventHandler) AddGiveFeedbackHandler(DependencyObject, GiveFeedbackEventHandler) AddGiveFeedbackHandler(DependencyObject, GiveFeedbackEventHandler)

Добавляет обработчик событий GiveFeedback к заданному объекту зависимости.Adds a GiveFeedback event handler to a specified dependency object.

AddPreviewDragEnterHandler(DependencyObject, DragEventHandler) AddPreviewDragEnterHandler(DependencyObject, DragEventHandler) AddPreviewDragEnterHandler(DependencyObject, DragEventHandler) AddPreviewDragEnterHandler(DependencyObject, DragEventHandler)

Добавляет обработчик событий PreviewDragEnter к заданному объекту зависимости.Adds a PreviewDragEnter event handler to a specified dependency object.

AddPreviewDragLeaveHandler(DependencyObject, DragEventHandler) AddPreviewDragLeaveHandler(DependencyObject, DragEventHandler) AddPreviewDragLeaveHandler(DependencyObject, DragEventHandler) AddPreviewDragLeaveHandler(DependencyObject, DragEventHandler)

Добавляет обработчик событий PreviewDragLeave к заданному объекту зависимости.Adds a PreviewDragLeave event handler to a specified dependency object.

AddPreviewDragOverHandler(DependencyObject, DragEventHandler) AddPreviewDragOverHandler(DependencyObject, DragEventHandler) AddPreviewDragOverHandler(DependencyObject, DragEventHandler) AddPreviewDragOverHandler(DependencyObject, DragEventHandler)

Добавляет обработчик событий PreviewDragOver к заданному объекту зависимости.Adds a PreviewDragOver event handler to a specified dependency object.

AddPreviewDropHandler(DependencyObject, DragEventHandler) AddPreviewDropHandler(DependencyObject, DragEventHandler) AddPreviewDropHandler(DependencyObject, DragEventHandler) AddPreviewDropHandler(DependencyObject, DragEventHandler)

Добавляет обработчик событий PreviewDrop к заданному объекту зависимости.Adds a PreviewDrop event handler to a specified dependency object.

AddPreviewGiveFeedbackHandler(DependencyObject, GiveFeedbackEventHandler) AddPreviewGiveFeedbackHandler(DependencyObject, GiveFeedbackEventHandler) AddPreviewGiveFeedbackHandler(DependencyObject, GiveFeedbackEventHandler) AddPreviewGiveFeedbackHandler(DependencyObject, GiveFeedbackEventHandler)

Добавляет обработчик событий PreviewGiveFeedback к заданному объекту зависимости.Adds a PreviewGiveFeedback event handler to a specified dependency object.

AddPreviewQueryContinueDragHandler(DependencyObject, QueryContinueDragEventHandler) AddPreviewQueryContinueDragHandler(DependencyObject, QueryContinueDragEventHandler) AddPreviewQueryContinueDragHandler(DependencyObject, QueryContinueDragEventHandler) AddPreviewQueryContinueDragHandler(DependencyObject, QueryContinueDragEventHandler)

Добавляет обработчик событий PreviewQueryContinueDrag к заданному объекту зависимости.Adds a PreviewQueryContinueDrag event handler to a specified dependency object.

AddQueryContinueDragHandler(DependencyObject, QueryContinueDragEventHandler) AddQueryContinueDragHandler(DependencyObject, QueryContinueDragEventHandler) AddQueryContinueDragHandler(DependencyObject, QueryContinueDragEventHandler) AddQueryContinueDragHandler(DependencyObject, QueryContinueDragEventHandler)

Добавляет обработчик событий QueryContinueDrag к заданному объекту зависимости.Adds a QueryContinueDrag event handler to a specified dependency object.

DoDragDrop(DependencyObject, Object, DragDropEffects) DoDragDrop(DependencyObject, Object, DragDropEffects) DoDragDrop(DependencyObject, Object, DragDropEffects) DoDragDrop(DependencyObject, Object, DragDropEffects)

Инициирует операцию перетаскивания.Initiates a drag-and-drop operation.

RemoveDragEnterHandler(DependencyObject, DragEventHandler) RemoveDragEnterHandler(DependencyObject, DragEventHandler) RemoveDragEnterHandler(DependencyObject, DragEventHandler) RemoveDragEnterHandler(DependencyObject, DragEventHandler)

Удаляет обработчик событий DragEnter из заданного объекта зависимости.Removes a DragEnter event handler from a specified dependency object.

RemoveDragLeaveHandler(DependencyObject, DragEventHandler) RemoveDragLeaveHandler(DependencyObject, DragEventHandler) RemoveDragLeaveHandler(DependencyObject, DragEventHandler) RemoveDragLeaveHandler(DependencyObject, DragEventHandler)

Удаляет обработчик событий DragLeave из заданного объекта зависимости.Removes a DragLeave event handler from a specified dependency object.

RemoveDragOverHandler(DependencyObject, DragEventHandler) RemoveDragOverHandler(DependencyObject, DragEventHandler) RemoveDragOverHandler(DependencyObject, DragEventHandler) RemoveDragOverHandler(DependencyObject, DragEventHandler)

Удаляет обработчик событий DragOver из заданного объекта зависимости.Removes a DragOver event handler from a specified dependency object.

RemoveDropHandler(DependencyObject, DragEventHandler) RemoveDropHandler(DependencyObject, DragEventHandler) RemoveDropHandler(DependencyObject, DragEventHandler) RemoveDropHandler(DependencyObject, DragEventHandler)

Удаляет обработчик событий Drop из заданного объекта зависимости.Removes a Drop event handler from a specified dependency object.

RemoveGiveFeedbackHandler(DependencyObject, GiveFeedbackEventHandler) RemoveGiveFeedbackHandler(DependencyObject, GiveFeedbackEventHandler) RemoveGiveFeedbackHandler(DependencyObject, GiveFeedbackEventHandler) RemoveGiveFeedbackHandler(DependencyObject, GiveFeedbackEventHandler)

Удаляет обработчик событий GiveFeedback из заданного объекта зависимости.Removes a GiveFeedback event handler from a specified dependency object.

RemovePreviewDragEnterHandler(DependencyObject, DragEventHandler) RemovePreviewDragEnterHandler(DependencyObject, DragEventHandler) RemovePreviewDragEnterHandler(DependencyObject, DragEventHandler) RemovePreviewDragEnterHandler(DependencyObject, DragEventHandler)

Удаляет обработчик событий PreviewDragEnter из заданного объекта зависимости.Removes a PreviewDragEnter event handler from a specified dependency object.

RemovePreviewDragLeaveHandler(DependencyObject, DragEventHandler) RemovePreviewDragLeaveHandler(DependencyObject, DragEventHandler) RemovePreviewDragLeaveHandler(DependencyObject, DragEventHandler) RemovePreviewDragLeaveHandler(DependencyObject, DragEventHandler)

Удаляет обработчик событий PreviewDragLeave из заданного объекта зависимости.Removes a PreviewDragLeave event handler from a specified dependency object.

RemovePreviewDragOverHandler(DependencyObject, DragEventHandler) RemovePreviewDragOverHandler(DependencyObject, DragEventHandler) RemovePreviewDragOverHandler(DependencyObject, DragEventHandler) RemovePreviewDragOverHandler(DependencyObject, DragEventHandler)

Удаляет обработчик событий PreviewDragOver из заданного объекта зависимости.Removes a PreviewDragOver event handler from a specified dependency object.

RemovePreviewDropHandler(DependencyObject, DragEventHandler) RemovePreviewDropHandler(DependencyObject, DragEventHandler) RemovePreviewDropHandler(DependencyObject, DragEventHandler) RemovePreviewDropHandler(DependencyObject, DragEventHandler)

Удаляет обработчик событий PreviewDrop из заданного объекта зависимости.Removes a PreviewDrop event handler from a specified dependency object.

RemovePreviewGiveFeedbackHandler(DependencyObject, GiveFeedbackEventHandler) RemovePreviewGiveFeedbackHandler(DependencyObject, GiveFeedbackEventHandler) RemovePreviewGiveFeedbackHandler(DependencyObject, GiveFeedbackEventHandler) RemovePreviewGiveFeedbackHandler(DependencyObject, GiveFeedbackEventHandler)

Удаляет обработчик событий PreviewGiveFeedback из заданного объекта зависимости.Removes a PreviewGiveFeedback event handler from a specified dependency object.

RemovePreviewQueryContinueDragHandler(DependencyObject, QueryContinueDragEventHandler) RemovePreviewQueryContinueDragHandler(DependencyObject, QueryContinueDragEventHandler) RemovePreviewQueryContinueDragHandler(DependencyObject, QueryContinueDragEventHandler) RemovePreviewQueryContinueDragHandler(DependencyObject, QueryContinueDragEventHandler)

Удаляет обработчик событий PreviewQueryContinueDrag из заданного объекта зависимости.Removes a PreviewQueryContinueDrag event handler from a specified dependency object.

RemoveQueryContinueDragHandler(DependencyObject, QueryContinueDragEventHandler) RemoveQueryContinueDragHandler(DependencyObject, QueryContinueDragEventHandler) RemoveQueryContinueDragHandler(DependencyObject, QueryContinueDragEventHandler) RemoveQueryContinueDragHandler(DependencyObject, QueryContinueDragEventHandler)

Удаляет обработчик событий QueryContinueDrag из заданного объекта зависимости.Removes a QueryContinueDrag event handler from a specified dependency object.

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

DragEnter DragEnter DragEnter DragEnter

Возникает при перетаскивании объекта в границы элемента, выступающего в качестве конечного расположения сброса.Occurs when an object is dragged into the bounds of an element that is acting as a drop target.

DragLeave DragLeave DragLeave DragLeave

Возникает при перетаскивании объекта за пределы границ элемента, выступающего в качестве места переноса, без отпускания объекта.Occurs when an object is dragged out of the bounds of an element that is acting as a drop target without being dropped.

DragOver DragOver DragOver DragOver

Возникает постоянно при перетаскивании объекта в границах элемента, выступающего в качестве цели перетаскивания.Occurs continuously while an object is dragged within the bounds of an element that is acting as a drop target.

Drop Drop Drop Drop

Возникает при помещении объекта в границах элемента, выступающего в качестве цели перетаскивания.Occurs when an object is dropped within the bounds of an element that is acting as a drop target.

GiveFeedback GiveFeedback GiveFeedback GiveFeedback

Возникает постоянно во время операции перетаскивания и позволяет источнику перетаскивания предоставлять пользователю сведения о взаимодействии.Occurs continuously while a drag-and-drop operation is in progress, and enables the drag source to give feedback to the user.

PreviewDragEnter PreviewDragEnter PreviewDragEnter PreviewDragEnter

Возникает при перетаскивании объекта в границы элемента, выступающего в качестве конечного расположения сброса.Occurs when an object is dragged into the bounds of an element that is acting as a drop target.

PreviewDragLeave PreviewDragLeave PreviewDragLeave PreviewDragLeave

Возникает при перетаскивании объекта за пределы границ элемента, выступающего в качестве места переноса, без отпускания объекта.Occurs when an object is dragged out of the bounds of an element that is acting as a drop target without being dropped.

PreviewDragOver PreviewDragOver PreviewDragOver PreviewDragOver

Возникает постоянно при перетаскивании объекта в границах элемента, выступающего в качестве цели перетаскивания.Occurs continuously while an object is dragged within the bounds of an element that is acting as a drop target.

PreviewDrop PreviewDrop PreviewDrop PreviewDrop

Возникает при помещении объекта в границах элемента, выступающего в качестве цели перетаскивания.Occurs when an object is dropped within the bounds of an element that is acting as a drop target.

PreviewGiveFeedback PreviewGiveFeedback PreviewGiveFeedback PreviewGiveFeedback

Возникает постоянно во время операции перетаскивания и позволяет источнику перетаскивания предоставлять пользователю сведения о взаимодействии.Occurs continuously while a drag-and-drop operation is in progress, and enables the drag source to give feedback to the user.

PreviewQueryContinueDrag PreviewQueryContinueDrag PreviewQueryContinueDrag PreviewQueryContinueDrag

Возникает непрерывно, пока выполняется операция перетаскивания, и позволяет источнику сброса завершить операцию перетаскивания в зависимости от состояния клавиши или кнопки.Occurs continuously while a drag-and-drop operation is in progress, and enables the drop source to end the drag-and-drop operation depending on the key/button states.

QueryContinueDrag QueryContinueDrag QueryContinueDrag QueryContinueDrag

Возникает непрерывно, пока выполняется операция перетаскивания, и позволяет источнику сброса завершить операцию перетаскивания в зависимости от состояния клавиши или кнопки.Occurs continuously while a drag-and-drop operation is in progress, and enables the drop source to end the drag-and-drop operation depending on the key/button states.

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

Дополнительно