UIElement.Drop Evento
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Si verifica quando il sistema di input segnala un evento di rilascio sottostante con questo elemento come destinazione di 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
Affinché Drop si verifichi e richiami un gestore, il valore di AllowDrop su UIElement che è la destinazione di rilascio e anche nell'origine dell'azione di trascinamento deve essere true.
Un gestore tipico verificherà il valore Data dai dati dell'evento DragEventArgs .
È possibile avviare un'azione di trascinamento della selezione su qualsiasi UIElement chiamando il metodo StartDragAsync . Dopo l'avvio dell'azione, qualsiasi UIElement nell'app può essere potenzialmente una destinazione di rilascio finché AllowDrop si trova 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 come trueDrop origine evento. Se l'evento è autorizzato a eseguire il bolle fino agli elementi padre perché non viene gestito, è possibile gestire l'evento in un elemento padre se AllowDrop si trova true nell'elemento padre. Gli elementi intermedi nella route che non sono l'oggetto gestore o la destinazione di rilascio non devono avere AllowDrop come true. Per altre info sul concetto di evento indirizzato, vedi Panoramica degli eventi e degli eventi indirizzati.
Per le azioni tocco, le azioni di trascinamento della selezione e anche per gli eventi di manipolazione o specifici dell'interazione che sono conseguenze di un'azione di tocco, un elemento deve essere visibile per essere l'origine evento e generare l'evento associato all'azione. UIElement.Visibility deve essere Visibile. 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.
Specifici controlli Windows Runtime possono avere una gestione basata su classi per l'eventoDrop. In tal caso, la logica del controllo ha probabilmente un override per il metodo OnDrop. In genere l'evento viene contrassegnato come gestito dal gestore della classe e l'evento non viene generato per la Drop gestione da parte di qualsiasi gestore 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.