Freigeben über


DragDrop Klasse

Definition

Bietet Hilfsmethoden und Felder für die Einleitung von Drag & Drop-Vorgängen, einschließlich einer Methode zum Starten eines Drag & Drop-Vorgangs, und Möglichkeiten zum Hinzufügen und Entfernen von Drag & Drop-bezogenen Ereignishandlern.

public ref class DragDrop abstract sealed
public static class DragDrop
type DragDrop = class
Public Class DragDrop
Vererbung
DragDrop

Hinweise

Drag-and-Drop bezieht sich im Allgemeinen auf eine Methode der Datenübertragung, bei der eine Maus (oder ein anderes Zeigegerät) zum Auswählen eines oder mehrerer Objekte verwendet wird, diese Objekte über ein gewünschtes Dropziel in der Benutzeroberfläche (UI) gezogen und gelöscht werden. Ein Drag-and-Drop-Vorgang entspricht einem Kopier- (oder Ausschneiden)- und Einfügevorgang, der zum Übertragen von Daten von einem Objekt oder einer Anwendung in ein anderes verwendet wird. Drag-and-Drop-Vorgänge umfassen in der Regel zwei Parteien: eine Ziehquelle, von der die gezogenen Daten stammen, und ein Ablageziel, das die gelöschten Daten empfängt. Die für Drag & Drop-Vorgänge erforderlichen Ereignisse und Methoden sind in der DragDrop-Klasse definiert. Die Drag-and-Drop-Ereignisse sind angefügte Ereignisse, die an ein beliebiges UIElement oder ContentElementangefügt werden können. Die Ziehquelle und das Ablageziel können Benutzeroberflächenelemente in derselben Anwendung oder in verschiedenen Anwendungen sein. Das Ablageziel muss jedoch wissen, wie die von der Ziehquelle übergebenen Daten verarbeitet werden.

Hinweis

Die UIElement Klassen und ContentElement enthalten Aliase für die Drag-and-Drop-Ereignisse, sodass die Ereignisse in der Klassenmemberliste angezeigt werden, wenn diese Klassen als Basisklasse geerbt werden. Wenn Sie einen Ereignishandler an ein Drag-and-Drop-Ereignis für eine dieser Klassen anfügen, wird der Handler an das zugrunde liegende DragDrop Ereignis angefügt, und er empfängt dieselbe instance von Ereignisdaten. Ein Beispiel finden Sie unter UIElement.Drop.

Die Ziehquelle leitet einen Drag & Drop-Vorgang durch Aufrufen der statischen DoDragDrop-Methode und Übergeben der übertragenen Daten an sie ein. Ein Element behandelt in der Regel die folgenden Ereignisse, wenn es sich um eine Ziehquelle handelt:

Ein Element behandelt in der Regel die folgenden Ereignisse, wenn es ein Ablageziel ist:

Weitere Informationen und Beispiele finden Sie unter Übersicht über Drag and Drop.

Felder

DragEnterEvent

Bezeichnet das angefügte DragEnter-Ereignis.

DragLeaveEvent

Bezeichnet das angefügte DragLeave-Ereignis.

DragOverEvent

Bezeichnet das angefügte DragOver-Ereignis.

DropEvent

Bezeichnet das angefügte Drop-Ereignis.

GiveFeedbackEvent

Bezeichnet das angefügte GiveFeedback-Ereignis.

PreviewDragEnterEvent

Bezeichnet das angefügte PreviewDragEnter-Ereignis.

PreviewDragLeaveEvent

Bezeichnet das angefügte PreviewDragLeave-Ereignis.

PreviewDragOverEvent

Bezeichnet das angefügte PreviewDragOver-Ereignis.

PreviewDropEvent

Bezeichnet das angefügte PreviewDrop-Ereignis.

PreviewGiveFeedbackEvent

Bezeichnet das angefügte PreviewGiveFeedback-Ereignis.

PreviewQueryContinueDragEvent

Bezeichnet das angefügte PreviewQueryContinueDrag-Ereignis.

QueryContinueDragEvent

Bezeichnet das angefügte QueryContinueDrag-Ereignis.

Methoden

AddDragEnterHandler(DependencyObject, DragEventHandler)

Fügt einem angegebenen Abhängigkeitsobjekt einen DragEnter-Ereignishandler hinzu.

AddDragLeaveHandler(DependencyObject, DragEventHandler)

Fügt einem angegebenen Abhängigkeitsobjekt einen DragLeave-Ereignishandler hinzu.

AddDragOverHandler(DependencyObject, DragEventHandler)

Fügt einem angegebenen Abhängigkeitsobjekt einen DragOver-Ereignishandler hinzu.

AddDropHandler(DependencyObject, DragEventHandler)

Fügt einem angegebenen Abhängigkeitsobjekt einen Drop-Ereignishandler hinzu.

AddGiveFeedbackHandler(DependencyObject, GiveFeedbackEventHandler)

Fügt einem angegebenen Abhängigkeitsobjekt einen GiveFeedback-Ereignishandler hinzu.

AddPreviewDragEnterHandler(DependencyObject, DragEventHandler)

Fügt einem angegebenen Abhängigkeitsobjekt einen PreviewDragEnter-Ereignishandler hinzu.

AddPreviewDragLeaveHandler(DependencyObject, DragEventHandler)

Fügt einem angegebenen Abhängigkeitsobjekt einen PreviewDragLeave-Ereignishandler hinzu.

AddPreviewDragOverHandler(DependencyObject, DragEventHandler)

Fügt einem angegebenen Abhängigkeitsobjekt einen PreviewDragOver-Ereignishandler hinzu.

AddPreviewDropHandler(DependencyObject, DragEventHandler)

Fügt einem angegebenen Abhängigkeitsobjekt einen PreviewDrop-Ereignishandler hinzu.

AddPreviewGiveFeedbackHandler(DependencyObject, GiveFeedbackEventHandler)

Fügt einem angegebenen Abhängigkeitsobjekt einen PreviewGiveFeedback-Ereignishandler hinzu.

AddPreviewQueryContinueDragHandler(DependencyObject, QueryContinueDragEventHandler)

Fügt einem angegebenen Abhängigkeitsobjekt einen PreviewQueryContinueDrag-Ereignishandler hinzu.

AddQueryContinueDragHandler(DependencyObject, QueryContinueDragEventHandler)

Fügt einem angegebenen Abhängigkeitsobjekt einen QueryContinueDrag-Ereignishandler hinzu.

DoDragDrop(DependencyObject, Object, DragDropEffects)

Leitet einen Drag & Drop-Vorgang ein.

RemoveDragEnterHandler(DependencyObject, DragEventHandler)

Entfernt einen DragEnter-Ereignishandler aus einem angegebenen Abhängigkeitsobjekt.

RemoveDragLeaveHandler(DependencyObject, DragEventHandler)

Entfernt einen DragLeave-Ereignishandler aus einem angegebenen Abhängigkeitsobjekt.

RemoveDragOverHandler(DependencyObject, DragEventHandler)

Entfernt einen DragOver-Ereignishandler aus einem angegebenen Abhängigkeitsobjekt.

RemoveDropHandler(DependencyObject, DragEventHandler)

Entfernt einen Drop-Ereignishandler aus einem angegebenen Abhängigkeitsobjekt.

RemoveGiveFeedbackHandler(DependencyObject, GiveFeedbackEventHandler)

Entfernt einen GiveFeedback-Ereignishandler aus einem angegebenen Abhängigkeitsobjekt.

RemovePreviewDragEnterHandler(DependencyObject, DragEventHandler)

Entfernt einen PreviewDragEnter-Ereignishandler aus einem angegebenen Abhängigkeitsobjekt.

RemovePreviewDragLeaveHandler(DependencyObject, DragEventHandler)

Entfernt einen PreviewDragLeave-Ereignishandler aus einem angegebenen Abhängigkeitsobjekt.

RemovePreviewDragOverHandler(DependencyObject, DragEventHandler)

Entfernt einen PreviewDragOver-Ereignishandler aus einem angegebenen Abhängigkeitsobjekt.

RemovePreviewDropHandler(DependencyObject, DragEventHandler)

Entfernt einen PreviewDrop-Ereignishandler aus einem angegebenen Abhängigkeitsobjekt.

RemovePreviewGiveFeedbackHandler(DependencyObject, GiveFeedbackEventHandler)

Entfernt einen PreviewGiveFeedback-Ereignishandler aus einem angegebenen Abhängigkeitsobjekt.

RemovePreviewQueryContinueDragHandler(DependencyObject, QueryContinueDragEventHandler)

Entfernt einen PreviewQueryContinueDrag-Ereignishandler aus einem angegebenen Abhängigkeitsobjekt.

RemoveQueryContinueDragHandler(DependencyObject, QueryContinueDragEventHandler)

Entfernt einen QueryContinueDrag-Ereignishandler aus einem angegebenen Abhängigkeitsobjekt.

Angefügte Ereignisse

DragEnter

Tritt auf, wenn ein Objekt in die Begrenzungen eines Elements gezogen wird, das als Drop-Ziel fungiert.

DragLeave

Tritt auf, wenn ein Objekt aus den Begrenzungen eines Elements, das als Drop-Ziel fungiert, gezogen, aber nicht abgelegt wird.

DragOver

Tritt fortlaufend auf, während ein Objekt innerhalb der Grenzen eines Elements gezogen wird, das als Ablageziel fungiert.

Drop

Tritt auf, wenn ein Objekt in den Begrenzungen eines Elements abgelegt wird, das als Drop-Ziel fungiert.

GiveFeedback

Tritt während des Ausführens eines Drag & Drop-Vorgangs fortlaufend auf und ermöglicht der Ziehquelle, dem Benutzer Rückmeldung zu geben.

PreviewDragEnter

Tritt auf, wenn ein Objekt in die Begrenzungen eines Elements gezogen wird, das als Drop-Ziel fungiert.

PreviewDragLeave

Tritt auf, wenn ein Objekt aus den Begrenzungen eines Elements, das als Drop-Ziel fungiert, gezogen, aber nicht abgelegt wird.

PreviewDragOver

Tritt fortlaufend auf, während ein Objekt innerhalb der Grenzen eines Elements gezogen wird, das als Ablageziel fungiert.

PreviewDrop

Tritt auf, wenn ein Objekt in den Begrenzungen eines Elements abgelegt wird, das als Drop-Ziel fungiert.

PreviewGiveFeedback

Tritt während des Ausführens eines Drag & Drop-Vorgangs fortlaufend auf und ermöglicht der Ziehquelle, dem Benutzer Rückmeldung zu geben.

PreviewQueryContinueDrag

Tritt fortlaufend auf, wenn ein Drag & Drop-Vorgang ausgeführt wird, und aktiviert die Ablagequelle, um den Drag & Drop-Vorgang abhängig von den Tasten-/Schaltflächenzuständen zu beenden.

QueryContinueDrag

Tritt fortlaufend auf, wenn ein Drag & Drop-Vorgang ausgeführt wird, und aktiviert die Ablagequelle, um den Drag & Drop-Vorgang abhängig von den Tasten-/Schaltflächenzuständen zu beenden.

Gilt für:

Weitere Informationen