Share via

UIElement.Drop Evento

  • Riferimento

Definizione

Spazio dei nomi:
Microsoft.UI.Xaml
Modifica

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

DragEventHandler

Commenti

Per Drop verificarsi e richiamare un gestore, il valore di AllowDropnell'UIElement è la destinazione di rilascio e anche nell'origine dell'azione di trascinamento deve essere true.

Un gestore tipico verificherà il valore Dati dai dati dell'evento DragEventArgs .

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

Drop è un evento instradato. Un elemento deve avere AllowDroptrue come origine Drop evento. Se l'evento è autorizzato a 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 eliminazione non devono essere trueAllowDrop. Per altre informazioni sul concetto di evento indirizzato, vedere 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 tocco, un elemento deve essere visibile al test 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à di 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 specifici Windows Runtime possono avere la gestione basata sulla classe 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 Drop non viene generato per la gestione da parte dei gestori di codice utente nel controllo. Per altre informazioni, vedi Panoramica degli eventi e degli eventi indirizzati.

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

Si applica a

Vedi anche