UIElement.DragEnter Evento

Definizione

Si verifica quando il sistema di input segnala un evento di trascinamento sottostante con questo elemento come destinazione.

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"/>

Tipo evento

Commenti

Affinché si verifichi un evento DragEnter, il valore di AllowDropsull'oggetto UIElement corrente e nell'origine evento deve essere true. In caso contrario, prendere in considerazione l'uso di PointerEntered.

È possibile avviare un'azione di trascinamento della selezione in qualsiasi UIElement chiamando il metodo StartDragAsync . Dopo l'avvio dell'azione, qualsiasi UIElement nell'app può essere potenzialmente una destinazione di rilascio, purché AllowDrop sia true su tale elemento. Tutti gli elementi passati dall'azione di trascinamento della selezione possono gestire DragEnter, DragLeave o DragOver.

DragEnter è un evento indirizzato. Per altre info sul concetto di evento indirizzato, vedi Panoramica degli eventi e degli eventi indirizzati.

Per le azioni di tocco, le azioni di trascinamento della selezione e anche per gli eventi di manipolazione o specifici dell'interazione che sono conseguenze di un'azione tocco, un elemento deve essere visibile per essere l'origine evento e generare l'evento associato all'azione. UIElement.Visibility deve essere Visible. Altre proprietà dei tipi derivati influiscono anche sulla visibilità degli hit test, ad esempio IsEnabled. Per altre informazioni, vedi Panoramica degli eventi e degli eventi indirizzati.

DragEnter supporta la possibilità di collegare gestori eventi alla route che verrà richiamata anche se i dati dell'evento per l'evento sono contrassegnati come Handled. Vedere AddHandler.

I controlli di Windows Runtime specifici possono avere una gestione basata su classi per l'evento DragEnter. In tal caso, il controllo ha probabilmente un override per il metodo OnDragEnter. In genere l'evento viene contrassegnato come gestito dal gestore della classe e l'evento DragEnter non viene generato per la gestione da parte di gestori di codice utente su tale controllo. Per altre informazioni, vedi Panoramica degli eventi e degli eventi indirizzati.

Indipendentemente dall'occorrenza dell'evento, alcuni controlli possono usare animazioni del tema, ad esempio DragItemThemeAnimation , per indicare visivamente un comportamento di trascinamento all'utente.

Windows 8/Windows 8.1 Prima di Windows 10, l'implementazione Windows Runtime dei concetti di trascinamento della selezione consente solo determinati controlli e azioni di input per avviare un'azione di trascinamento della selezione. Non esiste alcun metodo StartDragAsync o DoDragDrop generalizzato che consenta a qualsiasi elemento dell'interfaccia utente di avviare un'azione di trascinamento della selezione. L'origine principale di un'azione di trascinamento della selezione in un'app è quando si trascinano gli elementi di un elenco, ad esempio GridView.

Si applica a

Vedi anche