UIElement.Drop Evento
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Se produce cuando el sistema de entrada notifica un evento de colocación subyacente con este elemento como el destino de la colocación.
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 de evento
Comentarios
Para Drop que se produzca e invoque un controlador, el valor de AllowDrop en uiElement que es el destino de colocación y también en el origen de la acción de arrastrar y colocar debe ser true.
Un controlador típico comprobará el valor De datos de los datos del evento DragEventArgs .
Puede iniciar una acción de arrastrar y colocar en cualquier UIElement llamando al método StartDragAsync . Una vez iniciada la acción, cualquier UIElement elemento de la aplicación puede ser un destino de colocación siempre y cuando AllowDrop esté true en ese elemento, y cualquier elemento que pase la acción de arrastrar y colocar puede controlar DragEnter, DragLeave o DragOver.
Drop es un evento enrutado. Un elemento debe tener AllowDroptrue como origen Drop de eventos. Si el evento puede propagarse hasta elementos primarios porque no está controlado, es posible controlar el evento en un elemento primario si AllowDrop está true en el elemento primario. Los elementos intermedios de la ruta que no son el objeto de controlador o el destino de colocación no necesitan AllowDrop para que sea true. Para obtener más información sobre el concepto de eventos enrutados, consulta Información general sobre eventos y eventos enrutados.
En el caso de las acciones táctiles, las acciones de arrastrar y colocar y también para eventos específicos de interacción o manipulación que son consecuencias de una acción táctil, un elemento debe ser visible para que sea el origen del evento y activar el evento asociado a la acción. UIElement.Visibility debe ser Visible. Otras propiedades de los tipos derivados también afectan a la visibilidad de la prueba de posicionamiento, por ejemplo , IsEnabled. Para obtener más información, consulta Introducción a eventos y eventos enrutados.
Drop admite la capacidad de adjuntar controladores de eventos a la ruta que se invocará incluso si los datos del evento se marcan como Controlado. Consulte AddHandler.
Los controles de Windows Runtime específicos pueden tener control basado en clases para el Drop evento. Si es así, la lógica del control probablemente tiene una invalidación para el método OnDrop. Normalmente, el controlador de clases marca el evento y Drop no se genera el evento para controlarlo ningún controlador de código de usuario en ese control. Para obtener más información, consulta Introducción a eventos y eventos enrutados.
Independientemente de la repetición del evento, algunos controles pueden usar animaciones de tema como DragItemThemeAnimation para indicar visualmente un comportamiento de arrastre al usuario.