Share via

UIElement.DragEnter Ereignis

  • Referenz

Definition

Namespace:
Microsoft.UI.Xaml
Bearbeiten

Tritt auf, wenn das Eingabesystem ein zugrunde liegendes Ziehereignis mit diesem Element als Ziel meldet.

public:
 virtual event DragEventHandler ^ DragEnter;
// Register
event_token DragEnter(DragEventHandler const& handler) const;

// Revoke with event_token
void DragEnter(event_token const* cookie) const;

// Revoke with event_revoker
UIElement::DragEnter_revoker DragEnter(auto_revoke_t, DragEventHandler const& handler) const;
public event DragEventHandler DragEnter;
function onDragEnter(eventArgs) { /* Your code */ }
uIElement.addEventListener("dragenter", onDragEnter);
uIElement.removeEventListener("dragenter", onDragEnter);
- or -
uIElement.ondragenter = onDragEnter;
Public Custom Event DragEnter As DragEventHandler 
<uiElement DragEnter="eventhandler"/>

Ereignistyp

DragEventHandler

Hinweise

Damit ein DragEnter Ereignis auftritt, muss der Wert von AllowDrop für das aktuelle UIElement und für die Ereignisquelle lauten true. Andernfalls sollten Sie PointerEntered 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 ein Ablageziel sein, solange AllowDrop auf diesem Element ist true . Alle Elemente, über die die Drag-Drop-Aktion übergeben wird, können DragEnter, DragLeave oder DragOver verarbeiten.

DragEnter ist ein Routingereignis. 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.

DragEnter 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 DragEnter Ereignis. Wenn ja, hat das Steuerelement wahrscheinlich eine Überschreibung für die OnDragEnter-Methode. In der Regel wird das Ereignis vom Klassenhandler behandelt, und das DragEnter 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.

Gilt für:

Weitere Informationen