RoutedEventHandler Delegado

Definición

Espacio de nombres:

System.Windows

Ensamblado:

PresentationCore.dll

Representa el método que controlará los diversos eventos enrutados que no tienen datos de eventos específicos más allá de los datos comunes para todos los eventos enrutados.

public delegate void RoutedEventHandler(System::Object ^ sender, RoutedEventArgs ^ e);

public delegate void RoutedEventHandler(object sender, RoutedEventArgs e);

type RoutedEventHandler = delegate of obj * RoutedEventArgs -> unit

Public Delegate Sub RoutedEventHandler(sender As Object, e As RoutedEventArgs)

Parámetros

sender

Object

Objeto en que está asociado el controlador de eventos.

e

RoutedEventArgs

Datos del evento.

Comentarios

El RoutedEventHandler delegado se usa para cualquier evento enrutado que no notifique información específica del evento en los datos del evento. Hay muchos eventos enrutados; entre los ejemplos destacados se incluyen Click y Loaded.

La diferencia más notable entre escribir un controlador para un evento enrutado en lugar de un evento de Common Language Runtime (CLR) general es que el sender del evento (el elemento donde se adjunta e invoca el controlador) no se puede considerar necesariamente el origen del evento. El origen se notifica como una propiedad en los datos del evento (Source). Una diferencia entre sender y Source es el resultado del evento que se enruta a distintos elementos, durante el recorrido del evento enrutado a través de un árbol de elementos.

Puede usar o senderSource para una referencia de objeto si deliberadamente no está interesado en el comportamiento de enrutamiento de un evento enrutado directo o de propagación y solo tiene previsto controlar los eventos enrutados en los elementos en los que se generan por primera vez. En esta circunstancia, sender y Source son el mismo objeto.

Si piensa aprovechar las características inherentes de los eventos enrutados y escribir los controladores en consecuencia, las dos propiedades más importantes de los datos de eventos con las que trabajará al escribir controladores de eventos son Source y Handled.

Para determinadas combinaciones de eventos de entrada y clases de control WPF, el elemento que genera el evento no es el primer elemento que tiene la oportunidad de controlarlo. Si el evento de entrada tiene una versión preliminar del evento, la raíz del árbol de elementos tiene la primera oportunidad, puede establecer Handledtrue en en los datos del evento compartido y puede influir en cómo se notifica el evento de entrada a los elementos restantes en su ruta de eventos. El comportamiento de control de vista previa puede dar la apariencia de que un evento enrutado determinado no se genera según lo esperado. Para obtener más información, consulte Preview Events and Input Overview (Información general deentrada y eventos de vista previa).

Métodos de extensión