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 destino de 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 potencialmente un destino de colocación siempre que 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 se controla, 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 PermitirDrop para que sea true. Para obtener más información sobre el concepto de evento enrutado, 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 los eventos de interacción específicos o de manipulación que son consecuencias de una acción táctil, un elemento debe ser visible para ser el origen del evento y desencadenar el evento asociado a la acción. UIElement.Visibility debe ser Visible. Otras propiedades de tipos derivados también afectan a la visibilidad de las pruebas de posicionamiento, por ejemplo , IsEnabled. Para obtener más información, consulta Vista general de 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 Handled. Consulte AddHandler.
Es posible que determinados controles de Windows Runtime tengan 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 Vista general de eventos y eventos enrutados.
Independientemente de la aparición del evento, algunos controles pueden usar animaciones de tema como DragItemThemeAnimation para indicar visualmente un comportamiento de arrastre al usuario.