Informations
Le sujet que vous avez demandé est indiqué ci-dessous. Toutefois, ce sujet ne figure pas dans la bibliothèque.

UIElement.RemoveHandler, méthode

Mise à jour : novembre 2007

Supprime de cet élément le gestionnaire d'événement routé spécifié.

Espace de noms :  System.Windows
Assembly :  PresentationCore (dans PresentationCore.dll)

public void RemoveHandler(
	RoutedEvent routedEvent,
	Delegate handler
)
public final void RemoveHandler(
	RoutedEvent routedEvent,
	Delegate handler
)
public final function RemoveHandler(
	routedEvent : RoutedEvent, 
	handler : Delegate
)
Vous ne pouvez pas utiliser des méthodes en XAML.

Paramètres

routedEvent
Type : System.Windows.RoutedEvent

L'identificateur de l'événement routé pour lequel le gestionnaire est attaché.

handler
Type : System.Delegate

Implémentation spécifique du gestionnaire permettant de supprimer la collection de gestionnaires d'événements de cet élément.

Implémentations

IInputElement.RemoveHandler(RoutedEvent, Delegate)

Le scénario le plus courant pour utiliser cette API consiste à implémenter l'événement "wrapper" Common Language Runtime (CLR), associé à un événement routé personnalisé, au moment spécifique où vous implémentez le code de suppression ("remove") pour les gestionnaires de niveau CLR. L'exemple suivant le paragraphe Notes de cette page illustre ce scénario.

L'appel à cette méthode n'a aucun effet s'il n'existe aucun gestionnaire inscrit avec les critères qui correspondent aux paramètres d'entrée pour l'appel à la méthode.

Si plusieurs gestionnaires correspondant aux critères sont attachés, seul le premier gestionnaire dans le magasin de gestionnaires d'événements est supprimé. Ce comportement est cohérent avec le comportement CLR de l'opérateur -=.

Ni le routedEvent, ni le handler ne peuvent avoir la valeur null. L'affectation de la valeur null lève une exception.

Cette méthode ignore les informations du paramètre handledEventsToo fournies si le gestionnaire a été ajouté au préalable avec la signature AddHandler(RoutedEvent, Delegate, Boolean) qui active la gestion des événements déjà gérés. Le gestionnaire d'un des types prévus est supprimé.

L'exemple suivant utilise RemoveHandler dans le cadre de la définition d'un wrapper d'événement.

Public Shared ReadOnly TapEvent As RoutedEvent = EventManager.RegisterRoutedEvent("Tap", RoutingStrategy.Bubble, GetType(RoutedEventHandler), GetType(MyButtonSimple))

' Provide CLR accessors for the event
Public Custom Event Tap As RoutedEventHandler
    AddHandler(ByVal value As RoutedEventHandler)
        Me.AddHandler(TapEvent, value)
    End AddHandler

    RemoveHandler(ByVal value As RoutedEventHandler)
        Me.RemoveHandler(TapEvent, value)
    End RemoveHandler

    RaiseEvent(ByVal sender As Object, ByVal e As RoutedEventArgs)
        Me.RaiseEvent(e)
    End RaiseEvent
End Event


Windows Vista

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

.NET Framework

Pris en charge dans : 3.5, 3.0

Ajouts de la communauté

Afficher:
© 2014 Microsoft