Eventos de visualização

  • Artigo

Eventos de Visualização, também conhecidos como eventos de túnel, são eventos roteados em que a direção da rota vai da raiz do aplicativo em direção ao elemento que gerou o evento e é relatado como origem nos dados do evento. Nem todos os cenários de eventos têm suporte ou precisam de eventos de visualização. Este tópico descreve as situações em que os eventos de visualização existem, como aplicativos ou componentes devem lidar com eles e casos em que criar eventos de visualização em componentes ou classes personalizados pode ser apropriado.

Eventos de visualização e entrada

Quando você lida com eventos de Visualização em geral, tenha cuidado marcação de eventos manipulados nos dados. Manipular um evento de Visualização em qualquer elemento que não o elemento que o gerou (o elemento relatado como origem nos dados do evento) tem o efeito de não fornecer a um elemento a oportunidade de manipular o evento que o originou. Às vezes, esse será o resultado desejado, particularmente se os elementos em questão existirem em relacionamentos dentro da composição de um controle.

Especificamente para eventos de entrada, eventos de Visualização também compartilham instâncias de dados de evento com o evento de propagação equivalente. Se você usar um manipulador de classe de evento de Visualização para marcar o evento de entrada manipulado, o manipulador de classe de evento de entrada de propagação não será invocado. Ou, se você usar um manipulador de instância de evento de Visualização para marcar o evento manipulado, os manipuladores para o evento de propagação normalmente não serão invocados. Manipuladores de classe ou manipuladores de instância podem ser registrados ou anexados com uma opção a ser invocada mesmo que o evento esteja marcado como manipulado, mas essa técnica não costuma ser usada.

Para obter mais informações sobre manipulação de classes e como ela se relaciona a eventos de Visualização, consulte Marcando eventos roteados como manipulados e manipulação de classe.

Resolvendo a supressão de eventos por controles

Um cenário em que os eventos de Visualização são comumente usados é a manipulação de controles compostos de eventos de entrada. Às vezes, o autor do controle suprime a criação de um determinado evento em seu controle, talvez para substituir um evento definido por componente que carrega mais informações ou implica um comportamento mais específico. Por exemplo, um Windows Presentation Foundation (WPF) Button suprime MouseLeftButtonDown e borbulha eventos gerados pelo ou seus elementos compostos em favor de capturar o mouse e MouseRightButtonDown gerar um Click evento que é sempre gerado pelo ButtonButton próprio. O evento e seus dados ainda continuam ao longo da rota, mas como o Button marca os dados do evento como Handled, somente os manipuladores do evento que indicaram especificamente que devem agir no handledEventsToo caso são chamados. Se outros elementos na direção da raiz do seu aplicativo ainda quiserem ter uma oportunidade de lidar com um evento suprimido por controle, uma alternativa será anexar manipuladores ao código com handledEventsToo especificado como true. Porém, geralmente, uma técnica simples é alterar a direção de roteamento que você processa para que seja equivalente à de uma Visualização de um evento de entrada. Por exemplo, se um controle suprimir MouseLeftButtonDown, tente anexar um manipulador para PreviewMouseLeftButtonDown em vez disso. Essa técnica só funciona para eventos de entrada de elemento base, como MouseLeftButtonDown. Esses eventos de entrada usam pares de túnel/bolha, geram ambos os eventos e compartilham os dados do evento.

Cada uma dessas técnicas tem efeitos colaterais ou limitações. O efeito colateral de manipular o evento de Visualização é que manipular o evento nesse ponto pode desabilitar manipuladores que esperam manipular o evento de propagação e, portanto, a limitação é que geralmente não é uma boa ideia marcar o evento como manipulado enquanto ele ainda está na parte de Visualização da rota. A limitação da técnica é que você não pode especificar um manipulador em XAML como um handledEventsToo atributo, você deve registrar o manipulador de eventos no código depois de obter uma referência de handledEventsToo objeto para o elemento onde o manipulador deve ser anexado.

Confira também