DragDrop Klasse

Referenz

Definition

Namespace:: System.Windows

Assembly:: PresentationCore.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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: Object
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

DataObject