UIElement.PointerWheelChanged 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 cambia el valor delta de una rueda de puntero.
public:
virtual event PointerEventHandler ^ PointerWheelChanged;// Register
event_token PointerWheelChanged(PointerEventHandler const& handler) const;
// Revoke with event_token
void PointerWheelChanged(event_token const* cookie) const;
// Revoke with event_revoker
UIElement::PointerWheelChanged_revoker PointerWheelChanged(auto_revoke_t, PointerEventHandler const& handler) const;public event PointerEventHandler PointerWheelChanged;function onPointerWheelChanged(eventArgs) { /* Your code */ }
uIElement.addEventListener("pointerwheelchanged", onPointerWheelChanged);
uIElement.removeEventListener("pointerwheelchanged", onPointerWheelChanged);
- or -
uIElement.onpointerwheelchanged = onPointerWheelChanged;Public Custom Event PointerWheelChanged As PointerEventHandler <uielement PointerWheelChanged = "eventhandler" .../>
Tipo de evento
Comentarios
Al controlar PointerWheelChanged, normalmente le interesa el valor de la propiedad MouseWheelDelta :
- Llame a GetCurrentPoint desde pointerRoutedEventArgs disponible para el controlador. Esto devuelve un PointerPoint.
- Obtenga las propiedades de PointerPoint. Contiene un objeto PointerPointProperties .
- Obtenga el valor de la propiedad MouseWheelDelta del objeto PointerPointProperties . Un valor positivo indica que la rueda se ha girado hacia delante (lejos del usuario) o inclinada hacia la derecha; un valor negativo indica que la rueda se ha girado hacia atrás (hacia el usuario) o inclinada a la izquierda.
Si el elemento en el que se producen eventos de puntero tiene un valor ManipulationMode no predeterminado, la acción también podría dar lugar a varios eventos de manipulación como ManipulationStarted. Además, la entrada de rueda del mouse se puede controlar como un comportamiento de manipulación integrado por controles, incluso sin conjunto de valores ManipulationMode . Por ejemplo, ciertos controles como GridView y ListView pueden procesar la entrada de rueda del mouse para iniciar una acción de desplazamiento o movimiento panorámico.
PointerWheelChanged 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 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 las pruebas de posicionamiento. Para obtener más información, consulta Introducción a eventos y eventos enrutados.
PointerWheelChanged 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.
Los controles de Windows Runtime específicos pueden tener control basado en clases para el evento de entrada PointerWheelChanged. Si es así, el control probablemente tiene una invalidación para el método OnPointerWheelChanged. Normalmente, el evento está marcado como controlado por el controlador de clases y el evento PointerWheelChanged no se genera para controlarlo ningún controlador de código de usuario en ese control. Un control puede hacerlo para admitir el recorrido de sus elementos secundarios mediante una acción de rueda de puntero. Para obtener más información sobre cómo funciona el control basado en clases de eventos, consulte Información general sobre eventos y eventos enrutados.
Comportamiento de Windows 8
Para Windows 8, los gestos del dispositivo de panel de seguimiento que se controlaron mediante una parte de control ScrollViewer se interpretaron como entrada de rueda del mouse y, por lo tanto, desencadenarían un evento PointerWheelChanged. A partir de Windows 8.1, ScrollViewer usa una lógica de manipulación subyacente que interpreta los gestos del panel de seguimiento como acciones a las que responde ScrollViewer y, por tanto, el control considera el gesto y el evento PointerWheelChanged ya no se activa.
Si migras el código de la aplicación de Windows 8 a Windows 8.1 quizás quieras tener en cuenta este cambio de comportamiento, ya que da como resultado que PointerWheelChanged se desencadene en menos casos. Además, el comportamiento que ahora está integrado en ScrollViewer puede duplicar lo que el controlador habría hecho.
Las aplicaciones compiladas para Windows 8 que se ejecuten en Windows 8.1 siguen usando el comportamiento de Windows 8.