RoutedEventHandler Delegado

Definición

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.Represents the method that will handle various routed events that do not have specific event data beyond the data that is common for all routed events.

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.The object where the event handler is attached.

e
RoutedEventArgs

Datos del evento.The event data.

Herencia
RoutedEventHandler

Comentarios

El RoutedEventHandler delegado se usa para cualquier evento enrutado que no notifique información específica del evento en los datos de evento.The RoutedEventHandler delegate is used for any routed event that does not report event-specific information in the event data. Hay muchos eventos enrutados de este tipo: entre los ejemplos Click destacados Loadedse incluyen y.There are many such routed events; prominent examples include Click and Loaded.

La diferencia más notable entre escribir un controlador para un evento enrutado en lugar de un Common Language Runtime (CLR)common language runtime (CLR) evento general es que sender el del evento (el elemento donde se adjunta y se invoca el controlador) no se puede considerar necesariamente como el origen del evento.The most noteworthy difference between writing a handler for a routed event as opposed to a general Common Language Runtime (CLR)common language runtime (CLR) event is that the sender of the event (the element where the handler is attached and invoked) cannot be considered to necessarily be the source of the event. El origen se registra como una propiedad en los datos de eventoSource().The source is reported as a property in the event data (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.A difference between sender and Source is the result of the event being routed to different elements, during the traversal of the routed event through an element tree.

Puede usar sender o Source para una referencia de objeto si no está interesado intencionalmente 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.You can use either sender or Source for an object reference if you are deliberately not interested in the routing behavior of a direct or bubbling routed event and you only intend to handle routed events on the elements where they are first raised. En este caso, sender y Source son el mismo objeto.In this circumstance, sender and Source are the same object.

Si desea 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 evento con los que trabajará al escribir controladores de eventos son Source y Handled.If you do intend to take advantage of the inherent features of routed events and write your handlers accordingly, the two most important properties of the event data that you will work with when writing event handlers are Source and Handled.

Para ciertas combinaciones de eventos de entrada WPFWPF y clases de control, el elemento que genera el evento no es el primer elemento que tiene la oportunidad de controlarlo.For certain combinations of input events and WPFWPF control classes, the element that raises the event is not the first element that has the opportunity to handle it. Si el evento de entrada tiene una versión preliminar del evento, la raíz del árbol de elementos tiene la primera oportunidad, puede Handled establecerse true en en los datos de evento compartidos y puede influir en el modo en que se envía el evento de entrada a los elementos restantes en su ruta de evento.If the input event has a Preview version of the event, then the root of the element tree has first opportunity, can set Handled to true in the shared event data, and can influence how the input event is reported to remaining elements in its event route. El comportamiento de control de la vista previa puede dar la impresión de que un evento enrutado determinado no se genera según lo esperado.The Preview handling behavior can give the appearance that a particular routed event is not raised as expected. Para obtener más información, vea vista previa de eventos e información general de entrada.For more information, see Preview Events and Input Overview.

Métodos de extensión

GetMethodInfo(Delegate)

Obtiene un objeto que representa el método representado por el delegado especificado.Gets an object that represents the method represented by the specified delegate.

Se aplica a