UIElement.PointerReleased 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 se libera el dispositivo de puntero que inició previamente una acción Press , mientras se encuentra dentro de este elemento. Tenga en cuenta que no se garantiza que el final de una acción Press active un PointerReleased evento; otros eventos pueden activarse en su lugar. Para obtener más información, consulta Comentarios.
public:
virtual event PointerEventHandler ^ PointerReleased;// Register
event_token PointerReleased(PointerEventHandler const& handler) const;
// Revoke with event_token
void PointerReleased(event_token const* cookie) const;
// Revoke with event_revoker
UIElement::PointerReleased_revoker PointerReleased(auto_revoke_t, PointerEventHandler const& handler) const;public event PointerEventHandler PointerReleased;function onPointerReleased(eventArgs) { /* Your code */ }
uIElement.addEventListener("pointerreleased", onPointerReleased);
uIElement.removeEventListener("pointerreleased", onPointerReleased);
- or -
uIElement.onpointerreleased = onPointerReleased;Public Custom Event PointerReleased As PointerEventHandler <uiElement PointerReleased="eventhandler"/>
Tipo de evento
Comentarios
Las interacciones táctiles, del mouse y del lápiz/lápiz se reciben, procesan y administran como entrada de puntero en una aplicación. Cualquiera de estas interacciones puede producir un PointerReleased evento. Para obtener más información, consulta Controlar la entrada del puntero.
Otros eventos en lugar de PointerReleased pueden desencadenarse al final de la acción( por ejemplo, PointerCanceled o PointerCaptureLost. No confíes en PointerPressed y PointerReleased los eventos siempre se producen en pares. Para funcionar correctamente, la aplicación debe escuchar y controlar todos los eventos que representan las conclusiones probables de la acción Presionar . Algunas de las razones por las que es posible que no se produzca una PointerReleased repetición son:
- Diferencias en el modo en que el hardware específico controla las acciones táctiles y las acciones de prensa
- Captura de puntero mediante programación desde un puntero diferente
- Acciones del usuario que cambian la relación del área de presentación, como cambiar la resolución o la configuración del monitor
- Interacciones de entrada como un lápiz óptico tocando la misma superficie que una acción táctil anterior
La acción del usuario que desencadena un PointerReleased evento inicialmente puede dar lugar al Tapped evento o también puede dar lugar a RightTapped condiciones que varían por dispositivo. Para obtener más información, consulta Tapped y RightTapped.
La entrada de mouse se asocia con un solo puntero que se asigna cuando se detecta por primera vez la entrada. Al hacer clic en un botón del mouse (izquierdo, rueda o derecho), se crea una asociación secundaria entre el puntero y ese botón a través del evento PointerPressed. El PointerReleased evento solo se desencadena cuando se suelta el mismo botón del mouse (no se puede asociar ningún otro botón al puntero hasta que se complete este evento). Debido a esta asociación exclusiva, los clics de otros botones del mouse se enrutan a través del evento PointerMoved. Puede probar el estado del botón del mouse al controlar este evento, como se muestra en el ejemplo siguiente.
PointerReleased es un evento enrutado. 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 y también de los eventos de manipulación o específicos de la interacción que son consecuencia de una acción táctil, un elemento debe ser visible en la prueba de acceso para poder ser origen de eventos y generar el evento que está 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. Para obtener más información, consulta Introducción a eventos y eventos enrutados.
PointerReleased 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 PointerReleased evento de entrada. Si es así, es probable que el control tenga una invalidación para el método OnPointerReleased. Normalmente, el controlador de clases marca el evento y PointerReleased no se genera el evento para controlarlo ningún controlador de código de usuario en ese control. Para obtener más información sobre cómo funciona el control basado en clases para eventos, consulta Información general sobre eventos y eventos enrutados.
Los controles también pueden tener una animación de personalidad PointerUpThemeAnimation que se ejecuta independientemente del evento.