UIElement3D.AddHandler Méthode

Définition

Espace de noms:

System.Windows

Assembly:

PresentationCore.dll

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 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.

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

AddHandler(RoutedEvent, Delegate)

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.

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.