UIElement.OnPreviewStylusSystemGesture(StylusSystemGestureEventArgs) Método

Definição

Namespace:

System.Windows

Assembly:

PresentationCore.dll

Invocado quando um evento anexado PreviewStylusSystemGesture sem tratamento atinge um elemento em sua rota que deriva dessa classe. Implemente esse método para adicionar tratamento de classe a esse evento.

protected:
 virtual void OnPreviewStylusSystemGesture(System::Windows::Input::StylusSystemGestureEventArgs ^ e);

protected virtual void OnPreviewStylusSystemGesture (System.Windows.Input.StylusSystemGestureEventArgs e);

abstract member OnPreviewStylusSystemGesture : System.Windows.Input.StylusSystemGestureEventArgs -> unit
override this.OnPreviewStylusSystemGesture : System.Windows.Input.StylusSystemGestureEventArgs -> unit

Protected Overridable Sub OnPreviewStylusSystemGesture (e As StylusSystemGestureEventArgs)

Parâmetros

e

StylusSystemGestureEventArgs

O StylusSystemGestureEventArgs que contém os dados do evento.

Comentários

Esse método não tem implementação padrão. Como uma classe intermediária na herança pode implementar esse método, recomendamos que você chame a implementação base em sua implementação.

A finalidade desse método é semelhante aos métodos On* do padrão de evento CLR (Common Language Runtime): esse método fornece os meios para manipular o evento correspondente de classes derivadas estabelecendo um manipulador de classe em vez de um manipulador de instância. Nesse caso, o evento correspondente é um evento roteado. O padrão de implementação dos métodos On* é diferente para eventos roteados porque um evento roteado pode ser gerado por um elemento filho, que não é necessariamente o elemento que invocará manipuladores. Portanto, sua implementação precisa examinar as propriedades de origem dos dados do evento. Ele não deve tentar novamente o evento na maioria dos casos.

Substituindo esse método ou registrando manipuladores de classe com RegisterClassHandler, classes derivadas de podem chamar métodos de UIElement manipulador de classe privada quando o evento é recebido ao longo da rota de evento. Um cenário em que o tratamento de classe é apropriado é manipular os dados do evento e marcar o evento roteado como manipulado. Outro cenário especificamente para eventos de versão prévia é marcá-los manipulados para que os manipuladores de classe de propagação correspondentes não sejam invocados.

Confira também

• PreviewStylusSystemGesture