Partilhar via


UIElement.PointerWheelChanged Evento

Definição

Ocorre quando o valor delta de uma roda de ponteiro é alterado.

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

Comentários

Ao manipular PointerWheelChanged, você geralmente está interessado no valor da propriedade MouseWheelDelta :

  1. Chame GetCurrentPoint do PointerRoutedEventArgs disponível para o manipulador. Isso retorna um PointerPoint.
  2. Obter as propriedades do PointerPoint. Ele contém um objeto PointerPointProperties .
  3. Obtenha o valor da propriedade MouseWheelDelta do objeto PointerPointProperties . Um valor positivo indica que a roda foi girada para frente (longe do usuário) ou inclinada para a direita; um valor negativo indica que a roda foi girada para trás (em direção ao usuário) ou inclinada para a esquerda.

Se o elemento em que ocorrem eventos de ponteiro tiver um valor ManipulationMode não padrão, a ação também poderá resultar em vários eventos de manipulação, como ManipulationStarted. Além disso, a entrada da roda do mouse pode ser tratada como um comportamento de manipulação interno por controles, mesmo sem nenhum valor ManipulationMode definido. Por exemplo, determinados controles como GridView e ListView podem processar a entrada da roda do mouse para iniciar uma ação de rolagem/painel.

PointerWheelChanged é um evento roteado. Para obter mais informações sobre o conceito de evento roteado, consulte Visão geral de eventos e eventos roteado.

Para ações de toque e também para eventos específicos de interação ou de manipulação resultantes de uma ação de toque, é preciso que o elemento esteja visível para teste de clique, para ser a origem do evento e acionar o evento associado à ação. UIElement.Visibility deve ser Visível. Outras propriedades de tipos derivados também afetam a visibilidade do teste de clique. Para saber mais, confira Visão geral de eventos e eventos roteados.

PointerWheelChanged dá suporte à capacidade de anexar manipuladores de eventos à rota que será invocada mesmo se os dados do evento estiverem marcados como Manipulados. Consulte AddHandler.

Controles Windows Runtime específicos podem ter manipulação baseada em classe para o evento de entrada PointerWheelChanged. Nesse caso, o controle provavelmente tem uma substituição para o método OnPointerWheelChanged. Normalmente, o evento é marcado como manipulado pelo manipulador de classe e o evento PointerWheelChanged não é gerado para manipulação por nenhum manipulador de código de usuário nesse controle. Um controle pode fazer isso para dar suporte à passagem de seus elementos filho usando uma ação de roda de ponteiro. Para obter mais informações sobre como funciona o tratamento baseado em classe para eventos, consulte Visão geral de eventos e eventos roteado.

Comportamento do Windows 8

Para o Windows 8, os gestos do dispositivo de teclado de faixa que foram manipulados pela entrada por uma parte de controle ScrollViewer foram interpretados como entrada de roda do mouse e, portanto, disparariam um evento PointerWheelChanged. Começando com Windows 8.1, ScrollViewer usa uma lógica de manipulação subjacente que interpreta gestos de teclado de faixa como ações às quais o ScrollViewer responde e, portanto, o gesto é considerado manipulado pelo controle e o evento PointerWheelChanged não é mais acionado.

Se você migrar o código do aplicativo do Windows 8 para Windows 8.1 talvez queira considerar essa alteração de comportamento, pois isso resulta em PointerWheelChanged sendo acionado em menos casos. Além disso, o comportamento que agora está integrado ao ScrollViewer pode estar duplicando o que seu manipulador teria feito.

Os aplicativos que foram compilados para Windows 8, mas estão sendo executados no Windows 8.1, continuam a adotar o comportamento do Windows 8.

Aplica-se a

Confira também