UIElement.PointerWheelChanged Evento
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 :
- Chame GetCurrentPoint do PointerRoutedEventArgs disponível para o manipulador. Isso retorna um PointerPoint.
- Obtenha as Propriedades do PointerPoint. Ele contém um objeto PointerPointProperties .
- 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.