Class RoutedEvent

Represents a routed event definition in the Telerik WinControls framework, providing the identity and metadata necessary for event routing through the element tree.

Inheritance
System.Object
RoutedEvent
Inherited Members
System.Object.ToString()
System.Object.Equals(System.Object)
System.Object.Equals(System.Object, System.Object)
System.Object.ReferenceEquals(System.Object, System.Object)
System.Object.GetHashCode()
System.Object.GetType()
System.Object.MemberwiseClone()
Namespace: Telerik.WinControls
Assembly: Telerik.WinControls.dll

Syntax

public class RoutedEvent
Remarks

The RoutedEvent class serves as the definition and identifier for routed events within the framework. It contains the essential metadata needed to identify and route events through the visual element tree, including the event name and the type that owns the event.

Routed events enable sophisticated event handling patterns by allowing events to travel through the element hierarchy in either tunneling (preview) or bubbling directions. This class provides the foundational identity that the routed event system uses to match, route, and handle events appropriately.

Each routed event has a unique identity determined by the combination of its name and owner type, ensuring that different types can define events with the same name without conflicts, while maintaining clear event identity throughout the routing process.

Properties

EventName

Gets or sets the name of the routed event.

Declaration
public string EventName { get; set; }
Property Value
System.String

A string representing the event name that serves as the primary identifier for this routed event.
Remarks

The event name is a key component of the routed event's identity and is used throughout the routing system to match and identify events. It should be unique within the context of the owner type to prevent conflicts and ensure proper event resolution.

Event names typically follow standard .NET event naming conventions, often ending with descriptive terms that indicate the nature of the event (e.g., "Click", "Changed", "Loading").

OwnerType

Gets or sets the type that owns this routed event definition.

Declaration
public Type OwnerType { get; }
Property Value
System.Type

A System.Type representing the class that owns and defines this routed event.
Remarks

The owner type is the second component of the routed event's identity and represents the class that originally defined the routed event. Together with the event name, it creates a unique identifier that prevents naming conflicts between different types.

This property is not serialized in the designer to prevent unnecessary serialization of type information, as indicated by the System.ComponentModel.DesignerSerializationVisibility.Hidden attribute. The setter is marked as internal to control how owner types are assigned to routed events.

Extension Methods