Condividi tramite


UIElement.Drop Evento

Definizione

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

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

Tipo evento

Commenti

Per l'esecuzione di Drop e per richiamare un gestore, il valore di AllowDropnell'oggetto UIElement che rappresenta la destinazione di rilascio e anche nell'origine dell'azione di trascinamento deve essere true.

Un gestore tipico controlla il valore Data dai dati dell'evento DragEventArgs .

È 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 finché AllowDrop è true su tale elemento e tutti gli elementi passati dall'azione di trascinamento possono gestire DragEnter, DragLeave o DragOver.

Drop è un evento indirizzato. Un elemento deve avere AllowDrop essere true per essere un'origine evento Drop. Se l'evento può essere inserito in bolle fino agli elementi padre perché non viene gestito, è possibile gestire l'evento in un elemento padre se AllowDrop è true nell'elemento padre. Gli elementi intermedi nella route che non sono l'oggetto gestore o la destinazione di rilascio non devono essere true. 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.

Drop 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 Drop. In tal caso, la logica del controllo avrà probabilmente un override per il metodo OnDrop. In genere l'evento viene contrassegnato come gestito dal gestore di classi e l'evento Drop 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