UIElement3D.AddHandler Methode

Definition

Fügt einen Routingereignishandler für ein bestimmtes Routingereignis hinzu, wobei der Handler der Handlerauflistung für das aktuelle Element hinzugefügt wird.

Überlädt

AddHandler(RoutedEvent, Delegate)

Fügt einen Routingereignishandler für ein bestimmtes Routingereignis hinzu, wobei der Handler der Handlerauflistung für das aktuelle Element hinzugefügt wird.

AddHandler(RoutedEvent, Delegate, Boolean)

Fügt einen Routingereignishandler für ein bestimmtes Routingereignis hinzu, wobei der Handler der Handlerauflistung für das aktuelle Element hinzugefügt wird. Legen Sie handledEventsToo auf true fest, damit der bereitgestellte Handler für ein Routingereignis aufgerufen wird, das bereits von einem anderen Element auf der Ereignisroute als behandelt markiert wurde.

AddHandler(RoutedEvent, Delegate)

Fügt einen Routingereignishandler für ein bestimmtes Routingereignis hinzu, wobei der Handler der Handlerauflistung für das aktuelle Element hinzugefügt wird.

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)

Parameter

routedEvent
RoutedEvent

Ein Bezeichner für das zu behandelnde Routingereignis.

handler
Delegate

Ein Verweis auf die Handlerimplementierung.

Implementiert

Hinweise

Sie können denselben Handler für dasselbe Ereignis mehrmals hinzufügen, ohne eine Ausnahme zu auslösen. Der Handler wird jedoch tatsächlich mehrmals aufgerufen, wenn das Ereignis behandelt wird. Überlegen Sie daher, wie dieses Verhalten Nebenwirkungen haben kann, die in Ihrer Handlerimplementierung berücksichtigt werden sollten.

In der Regel verwenden Sie diese Methode, um die Implementierung des Accessors "add" für das Microsoft .NET-Ereigniszugriffsmuster eines benutzerdefinierten Routingereignisses bereitzustellen.

AddHandlerwird in der .NET Framework Version 3.5 eingeführt. Weitere Informationen finden Sie unter Versionen und Abhängigkeiten.

Gilt für:

AddHandler(RoutedEvent, Delegate, Boolean)

Fügt einen Routingereignishandler für ein bestimmtes Routingereignis hinzu, wobei der Handler der Handlerauflistung für das aktuelle Element hinzugefügt wird. Legen Sie handledEventsToo auf true fest, damit der bereitgestellte Handler für ein Routingereignis aufgerufen wird, das bereits von einem anderen Element auf der Ereignisroute als behandelt markiert wurde.

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)

Parameter

routedEvent
RoutedEvent

Ein Bezeichner für das zu behandelnde Routingereignis.

handler
Delegate

Ein Verweis auf die Handlerimplementierung.

handledEventsToo
Boolean

true, wenn der Handler registriert werden soll, sodass er selbst dann aufgerufen wird, wenn das Routingereignis in den zugehörigen Ereignisdaten als behandelt markiert ist; false, wenn der Handler mit der Standardbedingung registriert werden soll, dass er nicht aufgerufen wird, wenn das Routingereignis bereits als behandelt markiert ist.

Der Standardwert ist false.

Legen Sie die Anforderung zum erneuten Behandeln eines Routingereignisses nicht gewohnheitsmäßig fest.

Hinweise

Die praktische Verarbeitung von Eingabeereignissen auf niedriger Ebene ist eine komplexe Aufgabe. Viele Steuerelemente implementieren Verhalten, bei dem ein bestimmtes Ereignis als behandelt markiert und durch ein weiteres intuitiveres Ereignis ersetzt wird. Im Allgemeinen markiert ein Steuerelement ein Plattformeingabeereignis nur dann als behandelt, wenn eine Entwurfsabsicht dafür besteht. In bestimmten Szenarien sind diese Entwurfsabsichten möglicherweise nicht das, was Ihre spezielle Behandlung des Eingabeereignisses erfordert. Es ist für diese Szenarien, dass Handler bei handledEventsToo bedarfsgerecht true registriert werden. Aber Sie sollten dies nicht routinemäßig tun. Das Aufrufen von Handlern als Reaktion auf alle Ereignisse, auch wenn sie behandelt werden, erschwert ihre eigene Anwendungsereignisverarbeitungslogik. Es kann zu einer Leistungsminderung führen, wenn die Handlerlogik erheblich ist. Sie sollten die Verwendung von Anfügehandlern für bereits behandelte Ereignisse für Situationen reservieren, in denen Sie bereits während des Entwicklungsprozesses festgestellt haben, dass bestimmte Steuerelemente Ereignisse behandeln, die Sie weiterhin mit Anwendungslogik behandeln möchten.

Eine weitere Technik zum Vermeiden des Klassenbehandlungsverhaltens bestimmter Ereignis-Steuerelement-Kombinationen besteht darin, die Vorschaualternative dieses Ereignisses zu verwenden. Wenn MouseLeftButtonDown beispielsweise von der Klassenbehandlung behandelt markiert wird, können Sie stattdessen möglicherweise Handler hinzufügen PreviewMouseLeftButtonDown .

Sie können denselben Handler für dasselbe Ereignis mehrmals hinzufügen, ohne eine Ausnahme zu auslösen. Der Handler wird jedoch tatsächlich mehrmals aufgerufen, wenn das Ereignis behandelt wird. Überlegen Sie daher, wie dieses Verhalten Nebenwirkungen haben kann, die in Ihrer Handlerimplementierung berücksichtigt werden sollten.

In der Regel verwenden Sie diese Methode, um die Implementierung des Accessors "add" für das Microsoft .NET-Ereigniszugriffsmuster eines benutzerdefinierten Routingereignisses bereitzustellen.

AddHandlerwird in der .NET Framework Version 3.5 eingeführt. Weitere Informationen finden Sie unter Versionen und Abhängigkeiten.

Gilt für: