DragDrop Klasa

Definicja

Udostępnia metody i pola pomocnicze do inicjowania operacji przeciągania i upuszczania, w tym metody umożliwiającej rozpoczęcie operacji przeciągania i upuszczania, a także funkcje umożliwiające dodawanie i usuwanie procedur obsługi zdarzeń związanych z przeciągnięciem i upuszczanie.

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

Uwagi

Przeciąganie i upuszczanie często odwołuje się do metody transferu danych, która polega na użyciu myszy (lub innego urządzenia wskazującego) w celu wybrania jednego lub większej liczby obiektów, przeciągając te obiekty za pośrednictwem żądanego miejsca docelowego upuszczania w interfejsie użytkownika i upuszczając je. Operacja przeciągania i upuszczania jest analogiczna do operacji kopiowania (lub wycinania) i wklejania, która jest używana do przesyłania danych z jednego obiektu lub aplikacji do innego. Operacje przeciągania i upuszczania zwykle obejmują dwie strony: źródło przeciągania, z którego pochodzą przeciągane dane, oraz obiekt docelowy upuszczania, który odbiera porzucone dane. Zdarzenia i metody wymagane do operacji przeciągania i upuszczania są definiowane w DragDrop klasie . Zdarzenia przeciągania i upuszczania są dołączane do dowolnych UIElement zdarzeń lub ContentElement. Obiekt docelowy przeciągania źródła i upuszczania może być elementami interfejsu użytkownika w tej samej aplikacji lub w różnych aplikacjach. Jednak obiekt docelowy upuszczania musi wiedzieć, jak przetwarzać dane przekazywane przez źródło przeciągania.

Note

Klasy UIElement i ContentElement zawierają aliasy dla zdarzeń przeciągania i upuszczania, tak aby zdarzenia były wyświetlane na liście składowych klasy, gdy te klasy są dziedziczone jako klasa bazowa. Po dołączeniu programu obsługi zdarzeń do zdarzenia przeciągania i upuszczania w jednej z tych klas program obsługi jest dołączany do zdarzenia bazowego DragDrop i odbiera to samo wystąpienie danych zdarzenia. Na przykład zobacz UIElement.Drop.

Źródło przeciągania inicjuje operację przeciągania i upuszczania przez wywołanie metody statycznej DoDragDrop i przekazanie przesłanych do niego danych. Element zwykle obsługuje następujące zdarzenia, gdy jest źródłem przeciągania:

Element zwykle obsługuje następujące zdarzenia, gdy jest to element docelowy upuszczania:

Aby uzyskać więcej informacji i przykładów, zobacz Przeciąganie i upuszczanie — omówienie.

Pola

Nazwa Opis
DragEnterEvent

DragEnter Identyfikuje dołączone zdarzenie.

DragLeaveEvent

DragLeave Identyfikuje dołączone zdarzenie.

DragOverEvent

DragOver Identyfikuje dołączone zdarzenie.

DropEvent

Drop Identyfikuje dołączone zdarzenie.

GiveFeedbackEvent

GiveFeedback Identyfikuje dołączone zdarzenie.

PreviewDragEnterEvent

PreviewDragEnter Identyfikuje dołączone zdarzenie.

PreviewDragLeaveEvent

PreviewDragLeave Identyfikuje dołączone zdarzenie.

PreviewDragOverEvent

PreviewDragOver Identyfikuje dołączone zdarzenie.

PreviewDropEvent

PreviewDrop Identyfikuje dołączone zdarzenie.

PreviewGiveFeedbackEvent

PreviewGiveFeedback Identyfikuje dołączone zdarzenie.

PreviewQueryContinueDragEvent

PreviewQueryContinueDrag Identyfikuje dołączone zdarzenie.

QueryContinueDragEvent

QueryContinueDrag Identyfikuje dołączone zdarzenie.

Metody

Nazwa Opis
AddDragEnterHandler(DependencyObject, DragEventHandler)

Dodaje procedurę obsługi zdarzeń DragEnter do określonego obiektu zależności.

AddDragLeaveHandler(DependencyObject, DragEventHandler)

Dodaje procedurę obsługi zdarzeń DragLeave do określonego obiektu zależności.

AddDragOverHandler(DependencyObject, DragEventHandler)

Dodaje procedurę obsługi zdarzeń DragOver do określonego obiektu zależności.

AddDropHandler(DependencyObject, DragEventHandler)

Dodaje procedurę obsługi zdarzeń Drop do określonego obiektu zależności.

AddGiveFeedbackHandler(DependencyObject, GiveFeedbackEventHandler)

Dodaje procedurę obsługi zdarzeń GiveFeedback do określonego obiektu zależności.

AddPreviewDragEnterHandler(DependencyObject, DragEventHandler)

Dodaje procedurę obsługi zdarzeń PreviewDragEnter do określonego obiektu zależności.

AddPreviewDragLeaveHandler(DependencyObject, DragEventHandler)

Dodaje procedurę obsługi zdarzeń PreviewDragLeave do określonego obiektu zależności.

AddPreviewDragOverHandler(DependencyObject, DragEventHandler)

Dodaje procedurę obsługi zdarzeń PreviewDragOver do określonego obiektu zależności.

AddPreviewDropHandler(DependencyObject, DragEventHandler)

Dodaje procedurę obsługi zdarzeń PreviewDrop do określonego obiektu zależności.

AddPreviewGiveFeedbackHandler(DependencyObject, GiveFeedbackEventHandler)

Dodaje procedurę obsługi zdarzeń PreviewGiveFeedback do określonego obiektu zależności.

AddPreviewQueryContinueDragHandler(DependencyObject, QueryContinueDragEventHandler)

Dodaje procedurę obsługi zdarzeń PreviewQueryContinueDrag do określonego obiektu zależności.

AddQueryContinueDragHandler(DependencyObject, QueryContinueDragEventHandler)

Dodaje procedurę obsługi zdarzeń QueryContinueDrag do określonego obiektu zależności.

DoDragDrop(DependencyObject, Object, DragDropEffects)

Inicjuje operację przeciągania i upuszczania.

RemoveDragEnterHandler(DependencyObject, DragEventHandler)

DragEnter Usuwa program obsługi zdarzeń z określonego obiektu zależności.

RemoveDragLeaveHandler(DependencyObject, DragEventHandler)

DragLeave Usuwa program obsługi zdarzeń z określonego obiektu zależności.

RemoveDragOverHandler(DependencyObject, DragEventHandler)

DragOver Usuwa program obsługi zdarzeń z określonego obiektu zależności.

RemoveDropHandler(DependencyObject, DragEventHandler)

Drop Usuwa program obsługi zdarzeń z określonego obiektu zależności.

RemoveGiveFeedbackHandler(DependencyObject, GiveFeedbackEventHandler)

GiveFeedback Usuwa program obsługi zdarzeń z określonego obiektu zależności.

RemovePreviewDragEnterHandler(DependencyObject, DragEventHandler)

PreviewDragEnter Usuwa program obsługi zdarzeń z określonego obiektu zależności.

RemovePreviewDragLeaveHandler(DependencyObject, DragEventHandler)

PreviewDragLeave Usuwa program obsługi zdarzeń z określonego obiektu zależności.

RemovePreviewDragOverHandler(DependencyObject, DragEventHandler)

PreviewDragOver Usuwa program obsługi zdarzeń z określonego obiektu zależności.

RemovePreviewDropHandler(DependencyObject, DragEventHandler)

PreviewDrop Usuwa program obsługi zdarzeń z określonego obiektu zależności.

RemovePreviewGiveFeedbackHandler(DependencyObject, GiveFeedbackEventHandler)

PreviewGiveFeedback Usuwa program obsługi zdarzeń z określonego obiektu zależności.

RemovePreviewQueryContinueDragHandler(DependencyObject, QueryContinueDragEventHandler)

PreviewQueryContinueDrag Usuwa program obsługi zdarzeń z określonego obiektu zależności.

RemoveQueryContinueDragHandler(DependencyObject, QueryContinueDragEventHandler)

QueryContinueDrag Usuwa program obsługi zdarzeń z określonego obiektu zależności.

Zdarzenia dołączone

Nazwa Opis
DragEnter

Występuje, gdy obiekt jest przeciągany do granic elementu, który działa jako cel upuszczania.

DragLeave

Występuje, gdy obiekt jest przeciągany z granic elementu, który działa jako cel upuszczania bez porzucania.

DragOver

Występuje w sposób ciągły, gdy obiekt jest przeciągany w granicach elementu, który działa jako obiekt docelowy upuszczania.

Drop

Występuje, gdy obiekt jest porzucany w granicach elementu, który działa jako cel upuszczania.

GiveFeedback

Występuje w sposób ciągły, gdy trwa operacja przeciągania i upuszczania i umożliwia użytkownikowi przekazywanie opinii przez źródło przeciągania.

PreviewDragEnter

Występuje, gdy obiekt jest przeciągany do granic elementu, który działa jako cel upuszczania.

PreviewDragLeave

Występuje, gdy obiekt jest przeciągany z granic elementu, który działa jako cel upuszczania bez porzucania.

PreviewDragOver

Występuje w sposób ciągły, gdy obiekt jest przeciągany w granicach elementu, który działa jako obiekt docelowy upuszczania.

PreviewDrop

Występuje, gdy obiekt jest porzucany w granicach elementu, który działa jako cel upuszczania.

PreviewGiveFeedback

Występuje w sposób ciągły, gdy trwa operacja przeciągania i upuszczania i umożliwia użytkownikowi przekazywanie opinii przez źródło przeciągania.

PreviewQueryContinueDrag

Występuje w sposób ciągły, gdy operacja przeciągania i upuszczania jest w toku i umożliwia źródło upuszczania zakończenie operacji przeciągania i upuszczania w zależności od stanów klawisza/przycisku.

QueryContinueDrag

Występuje w sposób ciągły, gdy operacja przeciągania i upuszczania jest w toku i umożliwia źródło upuszczania zakończenie operacji przeciągania i upuszczania w zależności od stanów klawisza/przycisku.

Dotyczy

Zobacz też