RoutedEventArgs.RoutedEvent Property

Definition

Gets or sets the RoutedEvent associated with this RoutedEventArgs instance.

public:
 property System::Windows::RoutedEvent ^ RoutedEvent { System::Windows::RoutedEvent ^ get(); void set(System::Windows::RoutedEvent ^ value); };
public System.Windows.RoutedEvent RoutedEvent { get; set; }
member this.RoutedEvent : System.Windows.RoutedEvent with get, set
Public Property RoutedEvent As RoutedEvent

Property Value

The identifier for the event that has been invoked.

Exceptions

Attempted to change the RoutedEvent value while the event is being routed.

Examples

The following example creates new routed event data with an initial constructor and then sets the RoutedEvent property as a subsequent operation. You must have RoutedEvent set prior to raising the routed event.

protected virtual void OnSelectedColorChanged(Color oldColor, Color newColor)
{

    RoutedPropertyChangedEventArgs<Color> newEventArgs =
        new RoutedPropertyChangedEventArgs<Color>(oldColor, newColor);
    newEventArgs.RoutedEvent = ColorPicker.SelectedColorChangedEvent;
    RaiseEvent(newEventArgs);
}
Protected Overridable Sub OnSelectedColorChanged(ByVal oldColor As Color, ByVal newColor As Color)

    Dim newEventArgs As New RoutedPropertyChangedEventArgs(Of Color)(oldColor, newColor)
    newEventArgs.RoutedEvent = ColorPicker.SelectedColorChangedEvent
    MyBase.RaiseEvent(newEventArgs)
End Sub

Remarks

You cannot set this value on a RoutedEventArgs that has already been routed (for instance, if you obtained the arguments through a handler). Attempting to do so will generate an exception. You can only set it on an instance that has not yet been used to generate an invocation of the event.

The value of RoutedEvent cannot be null at any time.

Applies to