DragDrop Klasse

Definition

Stellt Hilfsmethoden und Felder zum Initiieren von Drag-and-Drop-Vorgängen bereit, einschließlich einer Methode zum Starten eines Drag-and-Drop-Vorgangs sowie Möglichkeiten zum Hinzufügen und Entfernen von Drag-and-Drop-zugehörigen 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 häufig auf eine Methode der Datenübertragung, die die Verwendung einer Maus (oder eines anderen Zeigegeräts) zum Auswählen eines oder mehrerer Objekte umfasst, indem sie diese Objekte über ein gewünschtes Dropziel auf der Benutzeroberfläche ziehen und ablegen. Ein Drag-and-Drop-Vorgang entspricht einem Kopier- (oder Ausschneiden)- und Einfügevorgang, der zum Übertragen von Daten von einem Objekt oder einer Anwendung an eine andere verwendet wird. Drag-and-Drop-Vorgänge umfassen in der Regel zwei Parteien: eine Ziehquelle, aus der die gezogenen Daten stammen, und ein Drop-Ziel, das die verworfenen Daten empfängt. Die Ereignisse und Methoden, die für Drag-and-Drop-Vorgänge erforderlich sind, werden in der DragDrop Klasse definiert. Die Drag-and-Drop-Ereignisse sind angefügte Ereignisse, die an beliebige UIElement oder ContentElement. Die Ziehquelle und das Ziel für das Ablegen können UI-Elemente in derselben Anwendung oder in verschiedenen Anwendungen sein. Das Dropziel muss jedoch wissen, wie die Daten verarbeitet werden, die von der Ziehquelle übergeben werden.

Note

Die UIElement Klassen und ContentElement Klassen 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 in einer dieser Klassen anfügen, wird der Handler an das zugrunde liegende DragDrop Ereignis angefügt und empfängt dieselbe Instanz von Ereignisdaten. Siehe zum Beispiel UIElement.Drop.

Die Ziehquelle initiiert einen Drag-and-Drop-Vorgang, indem die statische DoDragDrop Methode aufgerufen und die übertragenen Daten an sie übergeben werden. 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 sich um ein Dropziel handelt:

Weitere Informationen und Beispiele finden Sie unter "Drag and Drop Overview".

Felder

Name Beschreibung
DragEnterEvent

Identifiziert das DragEnter angefügte Ereignis.

DragLeaveEvent

Identifiziert das DragLeave angefügte Ereignis.

DragOverEvent

Identifiziert das DragOver angefügte Ereignis.

DropEvent

Identifiziert das Drop angefügte Ereignis.

GiveFeedbackEvent

Identifiziert das GiveFeedback angefügte Ereignis.

PreviewDragEnterEvent

Identifiziert das PreviewDragEnter angefügte Ereignis.

PreviewDragLeaveEvent

Identifiziert das PreviewDragLeave angefügte Ereignis.

PreviewDragOverEvent

Identifiziert das PreviewDragOver angefügte Ereignis.

PreviewDropEvent

Identifiziert das PreviewDrop angefügte Ereignis.

PreviewGiveFeedbackEvent

Identifiziert das PreviewGiveFeedback angefügte Ereignis.

PreviewQueryContinueDragEvent

Identifiziert das PreviewQueryContinueDrag angefügte Ereignis.

QueryContinueDragEvent

Identifiziert das QueryContinueDrag angefügte Ereignis.

Methoden

Name Beschreibung
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)

Initiiert einen Drag-and-Drop-Vorgang.

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

Name Beschreibung
DragEnter

Tritt auf, wenn ein Objekt in die Grenzen eines Elements gezogen wird, das als Dropziel fungiert.

DragLeave

Tritt auf, wenn ein Objekt aus den Grenzen eines Elements gezogen wird, das als Drop-Ziel fungiert, ohne gelöscht zu werden.

DragOver

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

Drop

Tritt auf, wenn ein Objekt innerhalb der Grenzen eines Elements abgelegt wird, das als Dropziel fungiert.

GiveFeedback

Tritt kontinuierlich auf, während ein Drag-and-Drop-Vorgang ausgeführt wird, und ermöglicht es der Ziehquelle, dem Benutzer Feedback zu geben.

PreviewDragEnter

Tritt auf, wenn ein Objekt in die Grenzen eines Elements gezogen wird, das als Dropziel fungiert.

PreviewDragLeave

Tritt auf, wenn ein Objekt aus den Grenzen eines Elements gezogen wird, das als Drop-Ziel fungiert, ohne gelöscht zu werden.

PreviewDragOver

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

PreviewDrop

Tritt auf, wenn ein Objekt innerhalb der Grenzen eines Elements abgelegt wird, das als Dropziel fungiert.

PreviewGiveFeedback

Tritt kontinuierlich auf, während ein Drag-and-Drop-Vorgang ausgeführt wird, und ermöglicht es der Ziehquelle, dem Benutzer Feedback zu geben.

PreviewQueryContinueDrag

Tritt kontinuierlich auf, während ein Drag-and-Drop-Vorgang ausgeführt wird, und ermöglicht es der Dropquelle, den Drag-and-Drop-Vorgang abhängig von den Zuständen der Taste/Schaltfläche zu beenden.

QueryContinueDrag

Tritt kontinuierlich auf, während ein Drag-and-Drop-Vorgang ausgeführt wird, und ermöglicht es der Dropquelle, den Drag-and-Drop-Vorgang abhängig von den Zuständen der Taste/Schaltfläche zu beenden.

Gilt für:

Weitere Informationen