UIElement.AddHandler Methode

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

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.

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

Beispiele

Im folgenden Beispiel wird ein Handler implementiert, der für das Initialized -Ereignis auf einer Seite aufgerufen wird, die einen definierten Handler mit einem der benannten Elemente auf der Seite anfügt handledEventsTootrue. Dieser Handler wird auch dann aufgerufen, wenn ein anderes Element entlang der Route die freigegebenen Ereignisdaten als behandelt markiert hat, bevor das Handling-Element in der Route erreicht wird.

void PrimeHandledToo(object sender, EventArgs e)
{
    dpanel2.AddHandler(Button.ClickEvent, new RoutedEventHandler(GetHandledToo), true);
}

Private Sub PrimeHandledToo(ByVal sender As Object, ByVal e As EventArgs)
    dpanel2.AddHandler(Button.ClickEvent, New RoutedEventHandler(AddressOf GetHandledToo), True)
End Sub

Hinweise

Die praktische Verarbeitung von Eingabeereignissen auf niedriger Ebene ist eine komplexe Aufgabe. Viele Steuerelemente implementieren Verhalten, bei dem ein bestimmtes Ereignis als behandelt gekennzeichnet wird, und wird durch ein anderes intuitiveres Ereignis ersetzt. Im Allgemeinen markiert ein Steuerelement ein Plattformeingabeereignis nur dann als behandelt, wenn dafür eine Entwurfsabsicht besteht. In bestimmten Szenarien sind diese Entwurfsabsichten möglicherweise nicht das, was Ihre spezielle Verarbeitung des Eingabeereignisses erfordert. Für diese Szenarien wird die Registrierung von handledEventsToo Handlern bei true bedarfsgerecht ausgeführt. Aber Sie sollten dies nicht routinemäßig tun. Das Aufrufen von Handlern als Reaktion auf alle Ereignisse, auch wenn sie verarbeitet werden, erschwert ihre eigene Anwendungsereignisverarbeitungslogik. Es kann zu einer Leistungsminderung führen, wenn die Handlerlogik erheblich ist. Sie sollten die Verwendung des Anfügens von Handlern 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 Methode zum Vermeiden des Klassenbehandlungsverhaltens bestimmter Ereignissteuerungskombinationen ist die Verwendung der Vorschaualternative dieses Ereignisses. Wenn MouseLeftButtonDown beispielsweise von der Klassenbehandlung behandelt markiert wird, können Sie stattdessen möglicherweise Handler für PreviewMouseLeftButtonDown hinzufügen.

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.