UIElement.DragOver 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 trascinamento sottostante per il quale l'elemento rappresenta la destinazione del rilascio potenziale.
public:
virtual event DragEventHandler ^ DragOver;// Register
event_token DragOver(DragEventHandler const& handler) const;
// Revoke with event_token
void DragOver(event_token const* cookie) const;
// Revoke with event_revoker
UIElement::DragOver_revoker DragOver(auto_revoke_t, DragEventHandler const& handler) const;public event DragEventHandler DragOver;function onDragOver(eventArgs) { /* Your code */ }
uIElement.addEventListener("dragover", onDragOver);
uIElement.removeEventListener("dragover", onDragOver);
- or -
uIElement.ondragover = onDragOver;Public Custom Event DragOver As DragEventHandler <uiElement DragOver="eventhandler"/>
Tipo evento
Commenti
Per consentire l'esecuzione di DragOver, il valore di AllowDropnell'oggetto UIElement corrente e nell'origine evento deve essere true. In caso contrario, prendere in considerazione l'uso di PointerMoved.
È 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.
DragOver è 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.
DragOver 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 Windows Runtime specifici possono avere una gestione basata su classi per l'evento DragOver. In tal caso, il controllo avrà probabilmente un override per il metodo OnDragOver. In genere l'evento viene contrassegnato come gestito dal gestore della classe e l'evento DragOver 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.