UIElement.OnPreviewStylusOutOfRange(StylusEventArgs) Método

Definición

Se invoca cuando un evento adjunto PreviewStylusOutOfRange sin controlar alcanza a un elemento derivado de esta clase en su ruta. Implemente este método a fin de agregar el control de clases para este evento.

protected:
 virtual void OnPreviewStylusOutOfRange(System::Windows::Input::StylusEventArgs ^ e);
protected virtual void OnPreviewStylusOutOfRange (System.Windows.Input.StylusEventArgs e);
abstract member OnPreviewStylusOutOfRange : System.Windows.Input.StylusEventArgs -> unit
override this.OnPreviewStylusOutOfRange : System.Windows.Input.StylusEventArgs -> unit
Protected Overridable Sub OnPreviewStylusOutOfRange (e As StylusEventArgs)

Parámetros

e
StylusEventArgs

Objeto StylusEventArgs que contiene los datos del evento.

Comentarios

Este método no tiene ninguna implementación predeterminada. Dado que una clase intermedia de la herencia podría implementar este método, se recomienda llamar a la implementación base en la implementación.

El propósito de este método es similar al patrón de eventos de Common Language Runtime (CLR) métodos On*: este método proporciona los medios para controlar el evento coincidente de las clases derivadas estableciendo un controlador de clases en lugar de un controlador de instancia. En este caso, el evento coincidente es un evento enrutado. El patrón de implementación de los métodos On* es diferente para los eventos enrutados porque un elemento secundario puede generar un evento enrutado, que no es necesariamente el elemento que invocará controladores. Por lo tanto, la implementación debe examinar las propiedades de origen de los datos del evento. No debe intentar recuperar el evento en la mayoría de los casos.

Mediante la invalidación de este método o mediante el registro de controladores de clases con RegisterClassHandler, las clases derivadas de pueden llamar a métodos de controlador de UIElement clases privadas cuando se recibe el evento a lo largo de la ruta del evento. Un escenario en el que el control de clases es adecuado es manipular los datos del evento y marcar el evento enrutado como controlado. Otro escenario específico para los eventos de vista previa es marcarlos controlados para que no se invoquen los controladores de clase de propagación coincidentes.

Se aplica a

Consulte también