ContentElement.RemoveHandler(RoutedEvent, Delegate) Méthode

Définition

Supprime le gestionnaire d’événements routés spécifié de cet élément.

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)

Paramètres

routedEvent
RoutedEvent

Identificateur de l’événement routé pour lequel le gestionnaire est attaché.

handler
Delegate

Implémentation de gestionnaire spécifique à supprimer de la collection de gestionnaires d’événements de cet élément.

Implémente

Remarques

Le scénario le plus courant pour l’utilisation de cette API est lorsque vous implémentez l’événement CLR (Common Language Runtime) « wrapper » associé à un événement routé personnalisé, en particulier lorsque vous implémentez la logique « remove » pour les gestionnaires au niveau du CLR. L’exemple suivant cette section remarques illustre ce scénario.

L’appel de cette méthode n’a aucun effet s’il n’y avait pas de gestionnaires inscrits avec des critères qui correspondent aux paramètres d’entrée de l’appel de méthode.

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

Ni ne routedEvent peut être null.handler Tentative de fournir l’une ou l’autre valeur, car elle null déclenchera une exception.

Cette méthode ignore les handledEventsToo informations de paramètre, qui sont fournies si le gestionnaire a été ajouté pour la première fois avec la signature qui active la AddHandler(RoutedEvent, Delegate, Boolean) gestion des événements déjà gérés. L’un ou l’autre type de gestionnaire est supprimé.

S’applique à

Voir aussi