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é 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.routed pour lequel le gestionnaire est attaché.
- handler
- Delegate
Implémentation de gestionnaire spécifique à supprimer de la collection de gestionnaires d’événements sur cet élément.
Implémente
Remarques
Le scénario le plus courant pour l’utilisation de cette API consiste à implémenter 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 qui suit cette section de remarques illustre ce scénario.
L’appel de cette méthode n’a aucun effet s’il n’y a 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 ni routedEvent ne handler peut être null. Toute tentative de fournir l’une ou l’autre valeur comme 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 AddHandler(RoutedEvent, Delegate, Boolean) signature qui permet la gestion des événements déjà gérés. L’un ou l’autre type de gestionnaire est supprimé.