RoutedEventHandler Delegate
Microsoft Silverlight will reach end of support after October 2021. Learn more.
Represents the method that will handle routed events.
Namespace: System.Windows
Assembly: System.Windows (in System.Windows.dll)
Syntax
'Declaration
Public Delegate Sub RoutedEventHandler ( _
sender As Object, _
e As RoutedEventArgs _
)
public delegate void RoutedEventHandler(
Object sender,
RoutedEventArgs e
)
Parameters
- sender
Type: System.Object
The object where the event handler is attached.
- e
Type: System.Windows.RoutedEventArgs
The event data.
Remarks
The RoutedEventHandler delegate is used for any routed event that does not report event-specific information in the event data. There are many such routed events; prominent examples include Loaded.
The most noteworthy difference between writing a handler for a routed event as opposed to a general 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. The source is reported as a property in the event data (OriginalSource). A difference between sender and OriginalSource is the result of the event being routed to different elements, during the traversal of the routed event through an element tree.
You can use either sender or OriginalSource 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. In this circumstance, sender and OriginalSource are the same object.
Version Information
Silverlight
Supported in: 5, 4, 3
Silverlight for Windows Phone
Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0
Platforms
For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.