UIElement.Drop 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 Drop-Ereignis mit diesem Element als Drop-Ziel meldet.
public:
virtual event DragEventHandler ^ Drop;// Register
event_token Drop(DragEventHandler const& handler) const;
// Revoke with event_token
void Drop(event_token const* cookie) const;
// Revoke with event_revoker
UIElement::Drop_revoker Drop(auto_revoke_t, DragEventHandler const& handler) const;public event DragEventHandler Drop;function onDrop(eventArgs) { /* Your code */ }
uIElement.addEventListener("drop", onDrop);
uIElement.removeEventListener("drop", onDrop);
- or -
uIElement.ondrop = onDrop;Public Custom Event Drop As DragEventHandler <uiElement Drop="eventhandler"/>
Ereignistyp
Hinweise
For Drop to occur and to invoke a handler, the value of AllowDrop on the UIElement that is the drop target and also on the drag-drop action source must be true.
Ein typischer Handler überprüft den Datenwert aus den DragEventArgs-Ereignisdaten .
Sie können eine Drag-Drop-Aktion für jedes UIElement initiieren, indem Sie die StartDragAsync-Methode aufrufen. Sobald die Aktion initiiert wurde, kann jede UIElement in der App ein Drop-Ziel sein, solange AllowDrop sich auf diesem Element befindet true , und alle Elemente, die die Drag-Drop-Aktion übergibt, dragEnter, DragLeave oder DragOver verarbeiten können.
Drop ist ein Routingereignis. Ein Element muss AllowDrop eine Ereignisquelle sein trueDrop . Wenn das Ereignis bis zu übergeordneten Elementen blasen darf, da es nicht behandelt wird, ist es möglich, das Ereignis für ein übergeordnetes Element zu behandeln, wenn AllowDrop sich auf dem übergeordneten Element befindet true . Zwischenelemente in der Route, die weder das Handlerobjekt noch das Drop-Ziel sind, müssen AllowDrop nicht sein true. Weitere Informationen zum Routingereigniskonzept finden Sie unter "Ereignisse und Routingereignisse".
Bei Touchaktionen, Drag-Drop-Aktionen und auch für interaktionsspezifische oder Manipulationsereignisse, die Folgen einer Touchaktion sind, muss ein Element treffertestbar sein, damit es sich um die Ereignisquelle handelt und das Ereignis auslöst, das der Aktion zugeordnet ist. UIElement.Visibility muss sichtbar sein. Andere Eigenschaften abgeleiteter Typen wirken sich auch auf die Sichtbarkeit von Treffertests aus, z. B. IsEnabled. Weitere Informationen finden Sie unter Übersicht über Ereignisse und Routingereignisse.
Drop unterstützt die Möglichkeit, Ereignishandler an die Route anzufügen, die aufgerufen wird, auch wenn die Ereignisdaten für das Ereignis als handled gekennzeichnet sind. Siehe "AddHandler".
Bestimmte Windows-Runtime-Steuerelemente verfügen möglicherweise über eine klassenbasierte Behandlung für das Drop Ereignis. Wenn ja, weist die Logik des Steuerelements wahrscheinlich eine Außerkraftsetzung für die Methode OnDrop auf. In der Regel wird das Ereignis vom Klassenhandler behandelt, und das Ereignis wird nicht für die Drop Behandlung durch Benutzercodehandler für dieses Steuerelement ausgelöst. Weitere Informationen finden Sie unter Übersicht über Ereignisse und Routingereignisse.
Unabhängig vom Auftreten des Ereignisses können einige Steuerelemente Designanimationen wie DragItemThemeAnimation verwenden, um ein Ziehverhalten für den Benutzer visuell anzuzeigen.