UIElement.DragEnter 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 arrastre subyacente con este elemento como destino.
public:
virtual event DragEventHandler ^ DragEnter;// Register
event_token DragEnter(DragEventHandler const& handler) const;
// Revoke with event_token
void DragEnter(event_token const* cookie) const;
// Revoke with event_revoker
UIElement::DragEnter_revoker DragEnter(auto_revoke_t, DragEventHandler const& handler) const;public event DragEventHandler DragEnter;function onDragEnter(eventArgs) { /* Your code */ }
uIElement.addEventListener("dragenter", onDragEnter);
uIElement.removeEventListener("dragenter", onDragEnter);
- or -
uIElement.ondragenter = onDragEnter;Public Custom Event DragEnter As DragEventHandler <uiElement DragEnter="eventhandler"/>
Tipo de evento
Comentarios
Para que se produzca un evento DragEnter, el valor de AllowDrop en el UIElement actual y en el origen del evento debe ser true. De lo contrario, considere la posibilidad de usar PointerEntered.
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 un destino de eliminación siempre que AllowDrop sea true en ese elemento. Cualquier elemento que pase la acción de arrastrar y colocar puede controlar DragEnter, DragLeave o DragOver.
DragEnter es un evento enrutado. 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.
DragEnter 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 de Windows Runtime específicos pueden tener control basado en clases para el evento DragEnter. Si es así, el control probablemente tiene una invalidación para el método OnDragEnter. Normalmente, el controlador de clases marca el evento y el evento DragEnter no se genera para su control por parte de 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.