UIElement.DragLeave Evento

Definizione

Spazio dei nomi:

Windows.UI.Xaml

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

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

Tipo evento

DragEventHandler

Commenti

Affinché si verifichi DragLeave, il valore di AllowDropsull'OGGETTO UIElement corrente e sull'origine evento deve essere true. In caso contrario, prendere in considerazione l'uso di PointerExited.

È 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.

DragLeave è 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.

DragLeave 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.

Specifici controlli Windows Runtime possono avere una gestione basata su classi per l'evento DragLeave. In tal caso, è probabile che il controllo abbia un override per il metodo OnDragLeave. In genere l'evento viene contrassegnato come gestito dal gestore della classe e l'evento DragLeave 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.

Vedi anche

• DragEventArgs
• DragEnter
• AllowDrop
• Panoramica degli eventi e degli eventi indirizzati
• Esempio di trascinamento della selezione (Windows 10)