DragDrop Klasse
Definition
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
-
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
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. |