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 del 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 la rueda del mouse se puede controlar como un comportamiento de manipulación integrado por los controles, incluso sin ManipulationMode ningún valor establecido. Por ejemplo, ciertos controles como GridView y ListView pueden procesar la entrada de la 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 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.
PointerWheelChanged 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 PointerWheelChanged evento de entrada. Si es así, el control probablemente tiene una invalidación para el método OnPointerWheelChanged. Normalmente, el controlador de clases marca el evento y PointerWheelChanged no se genera el evento 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 del puntero. 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.