ContentElement.RemoveHandler(RoutedEvent, Delegate) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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 -> unitPublic 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é.