DragDrop Klasa
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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
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. |