Compartilhar 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. Obtenha 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 a 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 de roda do mouse pode ser tratada como um comportamento de manipulação interno por controles, mesmo sem ManipulationMode nenhum valor 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 ocorrência. 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 que os dados do evento sejam marcados como Manipulados. Consulte AddHandler.

Controles de Windows Runtime específicos podem ter manipulação baseada em classe para o PointerWheelChanged evento de entrada. 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 PointerWheelChanged evento 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.

Aplica-se a

Confira também