Compartir a través de


ContentElement.RemoveHandler(RoutedEvent, Delegate) Método

Definición

Quita el controlador de eventos enrutados especificado de este elemento.

public:
 virtual void RemoveHandler(System::Windows::RoutedEvent ^ routedEvent, Delegate ^ handler);
public void RemoveHandler (System.Windows.RoutedEvent routedEvent, Delegate handler);
abstract member RemoveHandler : System.Windows.RoutedEvent * Delegate -> unit
override this.RemoveHandler : System.Windows.RoutedEvent * Delegate -> unit
Public Sub RemoveHandler (routedEvent As RoutedEvent, handler As Delegate)

Parámetros

routedEvent
RoutedEvent

Identificador del evento enrutado para el que se asocia el controlador.

handler
Delegate

Implementación de controlador específica que se va a quitar de la colección de controladores de eventos de este elemento.

Implementaciones

Comentarios

El escenario más común para usar esta API es cuando se implementa el evento "contenedor" de Common Language Runtime (CLR) asociado a un evento enrutado personalizado, específicamente cuando se implementa la lógica "remove" para los controladores en el nivel clR. El ejemplo que sigue a esta sección de comentarios ilustra este escenario.

Llamar a este método no tiene ningún efecto si no había controladores registrados con criterios que coincidan con los parámetros de entrada de la llamada al método.

Si se adjunta más de un controlador que coincida con los criterios, solo se quita el primer controlador del almacén de controladores de eventos. Este comportamiento es coherente con el comportamiento clR del -= operador.

Ni routedEvent ni handler pueden ser null. Si se intenta proporcionar cualquiera de los valores, se null producirá una excepción.

Este método omite la handledEventsToo información de parámetros, que se proporciona si el controlador se agregó por primera vez con la AddHandler(RoutedEvent, Delegate, Boolean) firma que permite el control de eventos ya controlados. Se quita cualquier tipo de controlador.

Se aplica a

Consulte también