Expand Minimize

ContentElement::RemoveHandler Method

Removes the specified routed event handler from this element.

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

public:
virtual void RemoveHandler(
	RoutedEvent^ routedEvent, 
	Delegate^ handler
) sealed

Parameters

routedEvent
Type: System.Windows::RoutedEvent

The identifier of the.routed event for which the handler is attached.

handler
Type: System::Delegate

The specific handler implementation to remove from the event handler collection on this element.

Implements

IInputElement::RemoveHandler(RoutedEvent, Delegate)

The most common scenario for using this API is when you implement the common language runtime (CLR) "wrapper" event that is associated with a custom routed event, specifically when you implement the "remove" logic for handlers at the CLR level. The example that follows this remarks section illustrates this scenario.

Calling this method has no effect if there were no handlers registered with criteria that match the input parameters for the method call.

If more than one handler is attached that matched the criteria, only the first handler in the event handler store is removed. This behavior is consistent with CLR behavior of the -= operator.

Neither routedEvent nor handler may be nullptr. Attempting to provide either value as nullptr will raise an exception.

This method ignores the handledEventsToo parameter information, which is provided if the handler was first added with the AddHandler(RoutedEvent, Delegate, Boolean) signature that enables handling of already-handled events. Either type of handler is removed.

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2015 Microsoft