Udostępnij za pośrednictwem


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 oraz obiekty do dodawania i usuwania procedur obsługi zdarzeń związanych z przeciągnięciem i upuszczaniem.

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

Uwagi

Przeciągnij i upuść często odnosi się do metody transferu danych, która obejmuje użycie myszy (lub innego urządzenia wskazującego), aby wybrać jeden lub więcej obiektów, przeciągając te obiekty na niektóre żądane miejsce docelowe upuszczania w interfejsie użytkownika i upuszczając je. Operacja przeciągania i upuszczania jest analogiczna do operacji kopiowania (lub wycinania) i wklejania używanej do transferu 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 cel 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łączone zdarzenia, które można dołączyć do dowolnego elementu UIElement lub ContentElement. Element docelowy przeciągania 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.

Uwaga

Klasy UIElement i ContentElement zawierają aliasy 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łączony do zdarzenia bazowego DragDrop i odbiera te same dane 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 do niego przesyłanych danych. Element zazwyczaj obsługuje następujące zdarzenia, gdy jest źródłem przeciągania:

Element zazwyczaj obsługuje następujące zdarzenia, gdy jest to cel upuszczania:

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

Pola

DragEnterEvent

Identyfikuje DragEnter dołączone zdarzenie.

DragLeaveEvent

Identyfikuje DragLeave dołączone zdarzenie.

DragOverEvent

Identyfikuje DragOver dołączone zdarzenie.

DropEvent

Identyfikuje Drop dołączone zdarzenie.

GiveFeedbackEvent

Identyfikuje GiveFeedback dołączone zdarzenie.

PreviewDragEnterEvent

Identyfikuje PreviewDragEnter dołączone zdarzenie.

PreviewDragLeaveEvent

Identyfikuje PreviewDragLeave dołączone zdarzenie.

PreviewDragOverEvent

Identyfikuje PreviewDragOver dołączone zdarzenie.

PreviewDropEvent

Identyfikuje PreviewDrop dołączone zdarzenie.

PreviewGiveFeedbackEvent

Identyfikuje PreviewGiveFeedback dołączone zdarzenie.

PreviewQueryContinueDragEvent

Identyfikuje PreviewQueryContinueDrag dołączone zdarzenie.

QueryContinueDragEvent

Identyfikuje QueryContinueDrag dołączone zdarzenie.

Metody

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)

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

RemoveDragLeaveHandler(DependencyObject, DragEventHandler)

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

RemoveDragOverHandler(DependencyObject, DragEventHandler)

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

RemoveDropHandler(DependencyObject, DragEventHandler)

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

RemoveGiveFeedbackHandler(DependencyObject, GiveFeedbackEventHandler)

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

RemovePreviewDragEnterHandler(DependencyObject, DragEventHandler)

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

RemovePreviewDragLeaveHandler(DependencyObject, DragEventHandler)

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

RemovePreviewDragOverHandler(DependencyObject, DragEventHandler)

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

RemovePreviewDropHandler(DependencyObject, DragEventHandler)

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

RemovePreviewGiveFeedbackHandler(DependencyObject, GiveFeedbackEventHandler)

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

RemovePreviewQueryContinueDragHandler(DependencyObject, QueryContinueDragEventHandler)

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

RemoveQueryContinueDragHandler(DependencyObject, QueryContinueDragEventHandler)

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

Zdarzenia dołączone

DragEnter

Występuje, gdy obiekt jest przeciągany do granic elementu działającego jako cel upuszczania.

DragLeave

Występuje, gdy obiekt jest przeciągany z granic elementu działającego jako cel upuszczania bez porzucania.

DragOver

Występuje stale, gdy obiekt jest przeciągany w granicach elementu działającego jako cel upuszczania.

Drop

Występuje, gdy obiekt jest porzucany w granicach elementu działającego jako cel upuszczania.

GiveFeedback

Występuje stale, 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 działającego jako cel upuszczania.

PreviewDragLeave

Występuje, gdy obiekt jest przeciągany z granic elementu działającego jako cel upuszczania bez porzucania.

PreviewDragOver

Występuje stale, gdy obiekt jest przeciągany w granicach elementu działającego jako cel upuszczania.

PreviewDrop

Występuje, gdy obiekt jest porzucany w granicach elementu działającego jako cel upuszczania.

PreviewGiveFeedback

Występuje stale, gdy trwa operacja przeciągania i upuszczania i umożliwia użytkownikowi przekazywanie opinii przez źródło przeciągania.

PreviewQueryContinueDrag

Występuje stale, 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 stale, 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ż