UIElement.OnQueryCursor(QueryCursorEventArgs) Método

Definição

Invocado quando um evento anexado QueryCursor 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 OnQueryCursor(System::Windows::Input::QueryCursorEventArgs ^ e);
protected virtual void OnQueryCursor (System.Windows.Input.QueryCursorEventArgs e);
abstract member OnQueryCursor : System.Windows.Input.QueryCursorEventArgs -> unit
override this.OnQueryCursor : System.Windows.Input.QueryCursorEventArgs -> unit
Protected Overridable Sub OnQueryCursor (e As QueryCursorEventArgs)

Parâmetros

e
QueryCursorEventArgs

O QueryCursorEventArgs 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.

Aplica-se a

Confira também