Développer Réduire

UIElement.RemoveHandler Method

Supprime le gestionnaire d'événements routés spécifié de cet UIElement. En général, le gestionnaire en question a été ajouté par AddHandler.

Syntaxe


public void RemoveHandler(
  RoutedEvent routedEvent, 
  object handler
)

Paramètres

routedEvent

Type: RoutedEvent

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

handler

Type: System.Object [.NET] | Platform::Object [C++]

Implémentation de gestionnaire spécifique permettant de supprimer la collection de gestionnaires d'événements de ce UIElement.

Remarques

RemoveHandler peut être utilisé pour les gestionnaires des événements pris en charge par AddHandler, qui correspond approximativement aux événements propres à l'entrée de UIElement. Plus précisément, l'événement doit avoir une propriété *Event de type RoutedEvent, qui a la valeur true uniquement pour certains événements d'UIElement. Vous ne pouvez pas utiliser RemoveHandler pour déconnecter les gestionnaires d'événements des événements Windows Runtime sur les instances de classe d'exécution en général. À la place, vous devez utiliser la syntaxe de décrochage de gestionnaire d'événements spécifique :

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

L'appel de cette méthode n'a aucun effet si aucun gestionnaire n'a été enregistré avec des critères qui correspondent aux paramètres d'entrée de l'appel de la méthode.

Cette méthode ignore si le paramètre handledEventsToo était défini sur true dans l'appel d'AddHandler qui était initialement joint au gestionnaire.

Configuration requise

Client minimal pris en charge

Windows 8

Serveur minimal pris en charge

Windows Server 2012

Espace de noms

Windows.UI.Xaml
Windows::UI::Xaml [C++]

Métadonnées

Windows.winmd

Voir aussi

AddHandler
UIElement
Vue d'ensemble des événements et des événements routés
RoutedEvent

 

 

Afficher:
© 2014 Microsoft. Tous droits réservés.