Expand Minimize

UIElement::RaiseEvent Method

Raises a specific routed event. The RoutedEvent to be raised is identified within the RoutedEventArgs instance that is provided (as the RoutedEvent property of that event data).

Namespace:  System.Windows
Assembly:  PresentationCore (in PresentationCore.dll)

public:
virtual void RaiseEvent(
	RoutedEventArgs^ e
) sealed

Parameters

e
Type: System.Windows::RoutedEventArgs

A RoutedEventArgs that contains the event data and also identifies the event to raise.

Implements

IInputElement::RaiseEvent(RoutedEventArgs)

The e parameter is typed as the common base type for all routed event data; however, the event data should be given as the most specific event data type that is available for the event being raised, because RoutedEventArgs derived classes contain the actual specific data properties that are intended for the specific event when it is raised.

RoutedEventArgs is not just the state properties for the event; it also identifies which routed event to raise. This event-raising pattern and the routed event data both differ from common language runtime (CLR) events and data classes, which typically just contain properties that are related to the event.

The following example creates event data, appends the event identifier to the data, and then uses the event data instance to raise a custom routed event.

No code example is currently available or this language may not be supported.

.NET Framework

Supported in: 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft