UIElement.RemoveHandler(RoutedEvent, Object) Méthode

Définition

Supprime le gestionnaire d’événements routés spécifié de cet UIElement. En règle générale, le gestionnaire en question a été ajouté par AddHandler.

C#
public void RemoveHandler(RoutedEvent routedEvent, object handler);

Paramètres

routedEvent
RoutedEvent

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

handler
Object

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

Remarques

RemoveHandler ne peut être utilisé que pour les gestionnaires d’événements pris en charge par AddHandler, qui sont approximativement les événements spécifiques aux entrées d’UIElement. Plus précisément, l’événement doit avoir une propriété *Event de type RoutedEvent, qui est vraie uniquement pour certains événements sur UIElement. Vous ne pouvez pas utiliser RemoveHandler pour détacher les gestionnaires d’événements pour les événements Windows Runtime sur les instances de classe runtime en général. Au lieu de cela, vous devez utiliser la syntaxe d’annulation du gestionnaire d’événements spécifique :

  • -= en C#
  • RemoveHandler dans Microsoft Visual Basic
  • -= dans les extensions de composant Visual C++ (C++/CX)

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.

Cette méthode ignore si le paramètre handledEventsToo était true dans l’appel AddHandler qui a initialement attaché le gestionnaire.

S’applique à

Produit Versions
WinRT Build 10240, Build 10586, Build 14383, Build 15063, Build 16299, Build 17134, Build 17763, Build 18362, Build 19041, Build 20348, Build 22000, Build 22621, Build 26100

Voir aussi