ContentElement.OnPreviewStylusButtonDown(StylusButtonEventArgs) Método

  • Referência

Definição

Namespace:
System.Windows
Assembly:
PresentationCore.dll

Invocado quando um evento anexado PreviewStylusButtonDown 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 public:
 virtual void OnPreviewStylusButtonDown(System::Windows::Input::StylusButtonEventArgs ^ e);
protected internal virtual void OnPreviewStylusButtonDown (System.Windows.Input.StylusButtonEventArgs e);
abstract member OnPreviewStylusButtonDown : System.Windows.Input.StylusButtonEventArgs -> unit
override this.OnPreviewStylusButtonDown : System.Windows.Input.StylusButtonEventArgs -> unit
Protected Friend Overridable Sub OnPreviewStylusButtonDown (e As StylusButtonEventArgs)

Parâmetros

e
StylusButtonEventArgs

O StylusButtonEventArgs que contém os dados do evento.

Comentários

Esse método não tem nenhuma 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 de clr (common language runtime): esse método fornece os meios para lidar com 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 recriar 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 ContentElement manipulador de classe privada quando o evento é recebido ao longo da rota do 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 que é especificamente para eventos de visualização é marcá-los manipulados para que os manipuladores de classe de bolhas correspondentes não sejam invocados.

Aplica-se a

Confira também