UIElement3D.AddHandler 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.
Ajoute un gestionnaire d’événements routé pour un événement routé spécifié, en ajoutant le gestionnaire à la collection de gestionnaires sur l’élément actuel.
Surcharges
AddHandler(RoutedEvent, Delegate) |
Ajoute un gestionnaire d’événements routé pour un événement routé spécifié, en ajoutant le gestionnaire à la collection de gestionnaires sur l’élément actuel. |
AddHandler(RoutedEvent, Delegate, Boolean) |
Ajoute un gestionnaire d’événements routé pour un événement routé spécifié, en ajoutant le gestionnaire à la collection de gestionnaires sur l’élément actuel. Spécifiez |
AddHandler(RoutedEvent, Delegate)
Ajoute un gestionnaire d’événements routé pour un événement routé spécifié, en ajoutant le gestionnaire à la collection de gestionnaires sur l’élément actuel.
public:
virtual void AddHandler(System::Windows::RoutedEvent ^ routedEvent, Delegate ^ handler);
public void AddHandler (System.Windows.RoutedEvent routedEvent, Delegate handler);
abstract member AddHandler : System.Windows.RoutedEvent * Delegate -> unit
override this.AddHandler : System.Windows.RoutedEvent * Delegate -> unit
Public Sub AddHandler (routedEvent As RoutedEvent, handler As Delegate)
Paramètres
- routedEvent
- RoutedEvent
Identificateur de l’événement routé à gérer.
- handler
- Delegate
Référence à l’implémentation du gestionnaire.
Implémente
Remarques
Vous pouvez ajouter le même gestionnaire pour le même événement plusieurs fois sans déclencher d’exception. Toutefois, le gestionnaire est appelé plusieurs fois lorsque l’événement est géré. Par conséquent, réfléchissez à la façon dont ce comportement peut avoir des effets secondaires qui doivent être pris en compte dans votre implémentation de gestionnaire.
Vous utilisez généralement cette méthode pour fournir l’implémentation de l’accesseur « add » pour le modèle d’accès aux événements Microsoft .NET d’un événement routé personnalisé.
AddHandler est introduit dans le .NET Framework version 3.5. Pour plus d’informations, consultez Versions et dépendances.
S’applique à
AddHandler(RoutedEvent, Delegate, Boolean)
Ajoute un gestionnaire d’événements routé pour un événement routé spécifié, en ajoutant le gestionnaire à la collection de gestionnaires sur l’élément actuel. Spécifiez handledEventsToo
comme true
pour que le gestionnaire fourni soit appelé pour un événement routé qui a déjà été marqué comme géré par un autre élément le long de son itinéraire.
public:
void AddHandler(System::Windows::RoutedEvent ^ routedEvent, Delegate ^ handler, bool handledEventsToo);
public void AddHandler (System.Windows.RoutedEvent routedEvent, Delegate handler, bool handledEventsToo);
member this.AddHandler : System.Windows.RoutedEvent * Delegate * bool -> unit
Public Sub AddHandler (routedEvent As RoutedEvent, handler As Delegate, handledEventsToo As Boolean)
Paramètres
- routedEvent
- RoutedEvent
Identificateur de l’événement routé à gérer.
- handler
- Delegate
Référence à l’implémentation du gestionnaire.
- handledEventsToo
- Boolean
true
pour inscrire le gestionnaire pour qu’il soit appelé même quand l’événement routé est marqué comme géré dans ses données d’événement ; false
pour inscrire le gestionnaire avec la condition par défaut selon laquelle il ne sera pas appelé si l’événement routé est déjà marqué comme géré.
La valeur par défaut est false
.
Ne demandez pas régulièrement à regérer un événement routé.
Remarques
Le traitement pratique des événements d’entrée de bas niveau est une tâche complexe. De nombreux contrôles implémentent un comportement où un événement donné est marqué comme géré et est remplacé par un autre événement plus intuitif. En règle générale, un contrôle marque un événement d’entrée de plateforme comme étant géré uniquement s’il existe une intention de conception. Dans certains scénarios, ces intentions de conception peuvent ne pas être ce que votre gestion particulière de l’événement d’entrée nécessite. C’est pour ces scénarios que l’inscription des gestionnaires avec handledEventsToo
le true
cas échéant. Mais vous ne devriez pas le faire régulièrement. L’appel de gestionnaires en réponse à tous les événements, même s’ils sont gérés, complique votre propre logique de traitement des événements d’application. Vous pouvez voir une diminution des performances si la logique du gestionnaire est importante. Vous devez réserver l’utilisation de l’attachement de gestionnaires pour les événements déjà gérés pour les situations où vous avez déjà découvert pendant le processus de développement que certains contrôles gèrent des événements que vous souhaitez toujours gérer avec la logique d’application.
Une autre technique pour éviter le comportement de gestion de classe de certaines combinaisons de contrôle d’événements consiste à utiliser l’alternative en préversion de cet événement. Par exemple, si MouseLeftButtonDown est marqué géré par la gestion des classes, vous pouvez ajouter des gestionnaires pour PreviewMouseLeftButtonDown à la place.
Vous pouvez ajouter le même gestionnaire pour le même événement plusieurs fois sans déclencher d’exception. Toutefois, le gestionnaire est appelé plusieurs fois lorsque l’événement est géré. Par conséquent, réfléchissez à la façon dont ce comportement peut avoir des effets secondaires qui doivent être pris en compte dans votre implémentation de gestionnaire.
Vous utilisez généralement cette méthode pour fournir l’implémentation de l’accesseur « add » pour le modèle d’accès aux événements Microsoft .NET d’un événement routé personnalisé.
AddHandler est introduit dans le .NET Framework version 3.5. Pour plus d’informations, consultez Versions et dépendances.
S’applique à
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour