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 que drop 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 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 de la aplicación puede ser potencialmente un destino de colocación siempre que AllowDrop sea 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 para que sea un origen de eventos Drop. Si el evento puede propagarse hasta elementos primarios porque no se controla, es posible controlar el evento en un elemento primario si AllowDrop es 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 permitir que AllowDrop 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 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 están marcados como Handled. Consulte AddHandler.
Los controles Windows Runtime específicos pueden tener control basado en clases para el evento Drop. Si es así, la lógica del control probablemente tiene una invalidación para el método OnDrop. Normalmente, el evento está marcado como controlado por el controlador de clases y el evento Drop no se genera 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.
Windows 8/Windows 8.1 anterior a Windows 10, la implementación Windows Runtime de conceptos de arrastrar y colocar permite que solo determinados controles y acciones de entrada inicien una acción de arrastrar y colocar. No hay ningún método StartDragAsync o DoDragDrop generalizado que permita que cualquier elemento de interfaz de usuario inicie una acción de arrastrar y colocar. El origen principal de una acción de arrastrar y colocar en una aplicación es cuando arrastras los elementos de una lista como GridView.