UIElement.DragOver Ereignis
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.
Tritt auf, wenn das Eingabesystem ein zugrunde liegendes Drag-Ereignis mit diesem Element als potenzielles Drop-Ziel meldet.
public:
virtual event DragEventHandler ^ DragOver;
// Register
event_token DragOver(DragEventHandler const& handler) const;
// Revoke with event_token
void DragOver(event_token const* cookie) const;
// Revoke with event_revoker
UIElement::DragOver_revoker DragOver(auto_revoke_t, DragEventHandler const& handler) const;
public event DragEventHandler DragOver;
function onDragOver(eventArgs) { /* Your code */ }
uIElement.addEventListener("dragover", onDragOver);
uIElement.removeEventListener("dragover", onDragOver);
- or -
uIElement.ondragover = onDragOver;
Public Custom Event DragOver As DragEventHandler
<uiElement DragOver="eventhandler"/>
Ereignistyp
Hinweise
Damit DragOver auftritt, muss der Wert von AllowDrop für das aktuelle UIElement und für die Ereignisquelle true sein. Andernfalls sollten Sie die Verwendung von PointerMoved in Betracht ziehen.
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, die die Drag-Drop-Aktion übergibt, können DragEnter, DragLeave oder DragOver verarbeiten.
DragOver ist ein Routingereignis. Weitere Informationen zum Konzept von Routingereignissen finden Sie unter Übersicht über Ereignisse und Routingereignisse.
Für Touchaktionen, Drag-Drop-Aktionen und auch für interaktionsspezifische Oder Manipulationsereignisse, die Folgen einer Toucheingabeaktion sind, muss ein Element treffertestbar sein, um die Ereignisquelle zu sein und das der Aktion zugeordnete Ereignis auszulösen. UIElement.Visibility muss Sichtbar sein. Andere Eigenschaften abgeleiteter Typen wirken sich ebenfalls auf die Sichtbarkeit von Treffertests aus, z. B. IsEnabled. Weitere Informationen finden Sie unter Übersicht über Ereignisse und Routingereignisse.
DragOver unterstützt die Möglichkeit, Ereignishandler an die Route anzufügen, die aufgerufen wird, auch wenn die Ereignisdaten für das Ereignis als Behandelt gekennzeichnet sind. Weitere Informationen finden Sie unter AddHandler.
Bestimmte Windows-Runtime Steuerelemente verfügen möglicherweise über eine klassenbasierte Behandlung für das DragOver-Ereignis. Wenn dies der Grund ist, verfügt das Steuerelement wahrscheinlich über eine Außerkraftsetzung für die OnDragOver-Methode. In der Regel wird das Ereignis vom Klassenhandler behandelt, und das DragOver-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 ermöglicht, 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.