UIElement.DragLeave Ereignis
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.
Tritt auf, wenn das Eingabesystem ein zugrunde liegendes Ziehereignis mit diesem Element als Ursprung meldet.
public:
virtual event DragEventHandler ^ DragLeave;// Register
event_token DragLeave(DragEventHandler const& handler) const;
// Revoke with event_token
void DragLeave(event_token const* cookie) const;
// Revoke with event_revoker
UIElement::DragLeave_revoker DragLeave(auto_revoke_t, DragEventHandler const& handler) const;public event DragEventHandler DragLeave;function onDragLeave(eventArgs) { /* Your code */ }
uIElement.addEventListener("dragleave", onDragLeave);
uIElement.removeEventListener("dragleave", onDragLeave);
- or -
uIElement.ondragleave = onDragLeave;Public Custom Event DragLeave As DragEventHandler <uiElement DragLeave="eventhandler"/>
Damit DragLeave auftritt, muss der Wert von AllowDrop für das aktuelle UIElement und für die Ereignisquelle true sein. Andernfalls sollten Sie PointerExited verwenden.
Sie können eine Drag-Drop-Aktion für ein beliebiges UIElement initiieren, indem Sie die StartDragAsync-Methode aufrufen. Sobald die Aktion initiiert wurde, kann jedes UIElement in der App möglicherweise ein Ablageziel sein, solange AllowDrop für dieses Element true ist. Alle Elemente, über die die Drag-Drop-Aktion übergeben wird, können DragEnter, DragLeave oder DragOver verarbeiten.
DragLeave ist ein routingfähiges Ereignis. Weitere Informationen zum Konzept für routingfähige Ereignisse finden Sie unter Übersicht über Ereignisse und routingfähige Ereignisse.
Für Touchaktionen, Drag-Drop-Aktionen und auch für Interaktions- oder Manipulationsereignisse, die Folgen einer Touchaktion sind, muss ein Element treffertest sichtbar sein, um die Ereignisquelle zu sein und das Ereignis auszulösen, das der Aktion zugeordnet ist. UIElement.Visibility muss sichtbar sein. Andere Eigenschaften abgeleiteter Typen wirken sich auch auf die Treffertestsicht aus, z. B. IsEnabled. Weitere Informationen finden Sie unter Übersicht über Ereignisse und Routingereignisse.
DragLeave unterstützt die Möglichkeit, Ereignishandler an die Route anzufügen, die aufgerufen wird, auch wenn die Ereignisdaten für das Ereignis als Verarbeitet gekennzeichnet sind. Weitere Informationen finden Sie unter AddHandler.
Bestimmte Windows-Runtime-Steuerelemente verfügen möglicherweise über eine klassenbasierte Behandlung für das DragLeave-Ereignis. Wenn ja, verfügt das Steuerelement wahrscheinlich über eine Überschreibung für die Methode OnDragLeave. In der Regel wird das Ereignis vom Klassenhandler behandelt, und das DragLeave-Ereignis wird nicht zur Behandlung von Benutzercodehandlern für dieses Steuerelement ausgelöst. Weitere Informationen finden Sie unter Übersicht über Ereignisse und Routingereignisse.
Unabhängig vom Ereignisereignis können einige Steuerelemente Designanimationen wie DragItemThemeAnimation verwenden, um dem Benutzer visuell ein Ziehverhalten anzuzeigen.
Windows 8/Windows 8.1 Vor Windows 10 ermöglicht die Windows-Runtime Implementierung von Drag-Drop-Konzepten nur bestimmten Steuerelementen und Eingabeaktionen, eine Drag-Drop-Aktion zu initiieren. Es gibt keine StartDragAsync - oder generalisierte DoDragDrop-Methode , die es jedem UI-Element erlauben würde, eine Drag-Drop-Aktion zu initiieren. Die Standard Quelle einer Drag-Drop-Aktion in einer App ist, wenn Sie die Elemente einer Liste wie GridView ziehen.
| Produkt | Versionen |
|---|---|
| WinRT | Build 10240, Build 10586, Build 14383, Build 15063, Build 16299, Build 17134, Build 17763, Build 18362, Build 19041, Build 20348, Build 22000, Build 22621, Build 26100 |