RemoveHandler Método (RoutedEvent, Delegate)
TOC
Collapse the table of content
Expand the table of content
Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

UIElement.RemoveHandler (Método) (RoutedEvent, Delegate)

 

Quita el controlador de eventos enrutados especificado de este elemento.

Espacio de nombres:   System.Windows
Ensamblado:  PresentationCore (en PresentationCore.dll)

public void RemoveHandler(
	RoutedEvent routedEvent,
	Delegate handler
)

Parámetros

routedEvent

Identificador del evento enrutado al que se adjunta el controlador.

handler

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

El escenario más común para usar esta API es la implementación del evento de "contenedor" de common language runtime (CLR) asociado a un evento enrutado personalizado, específicamente cuando se implementa la lógica de "quitar" para los controladores en el nivel de CLR.En el ejemplo que sigue a esta sección Comentarios se muestra este escenario.

Llamar a este método no tiene efecto si no se ha registrado ningún controlador con criterios que coincidan con los parámetros de entrada para la llamada al método.

Si hay más de un controlador asociado que coincide con los criterios, se quita sólo el primer controlador del almacén de controladores de eventos.Este comportamiento es coherente con el comportamiento de CLR del operador -=.

routedEvent y handler no pueden ser null.Si se intenta proporcionar cualquiera de estos valores como null, se producirá una excepción.

Este método omite la información del parámetro handledEventsToo, que se proporciona si el controlador se agregó primero con la firma AddHandler(RoutedEvent, Delegate, Boolean) que habilita el control de eventos ya administrados.Se quita cualquier tipo de controlador.

En el ejemplo siguiente se usa RemoveHandler como parte de una definición de contenedor de eventos.

public static readonly RoutedEvent TapEvent = EventManager.RegisterRoutedEvent(
    "Tap", RoutingStrategy.Bubble, typeof(RoutedEventHandler), typeof(MyButtonSimple));

// Provide CLR accessors for the event
public event RoutedEventHandler Tap
{
        add { AddHandler(TapEvent, value); } 
        remove { RemoveHandler(TapEvent, value); }
}

.NET Framework
Disponible desde 3.0
Silverlight
Disponible desde 3.0
Windows Phone Silverlight
Disponible desde 7.0
Volver al principio
Mostrar:
© 2016 Microsoft