UIElement.RemoveHandler(RoutedEvent, Object) Methode

Definition

Namespace:

Microsoft.UI.Xaml

Entfernt den angegebenen Routingereignishandler aus diesem UIElement. In der Regel wurde der betreffende Handler von AddHandler hinzugefügt.

public:
 virtual void RemoveHandler(RoutedEvent ^ routedEvent, Platform::Object ^ handler) = RemoveHandler;

void RemoveHandler(RoutedEvent const& routedEvent, IInspectable const& handler);

public void RemoveHandler(RoutedEvent routedEvent, object handler);

function removeHandler(routedEvent, handler)

Public Sub RemoveHandler (routedEvent As RoutedEvent, handler As Object)

Parameter

routedEvent

RoutedEvent

Der Bezeichner des Routingereignisses, für das der Handler angefügt wurde.

handler

Object

Platform::Object

IInspectable

Die spezifische Handlerimplementierung, die aus der Ereignishandlerauflistung für dieses UIElement entfernt werden soll.

Hinweise

RemoveHandler kann nur für die Ereignishandler der Ereignisse verwendet werden, die von AddHandler unterstützt werden. Dies entspricht ungefähr den eingabespezifischen Ereignissen von UIElement. Genauer gesagt muss das Ereignis über eine *Event-Eigenschaft vom Typ RoutedEvent verfügen, die nur für bestimmte Ereignisse auf UIElementgilt. Sie können nicht verwendenRemoveHandler, um Ereignishandler für Windows-Runtime Ereignisse auf Laufzeitklasseninstanzen im Allgemeinen zu enthooken. Stattdessen sollten Sie die Syntax des C#-Ereignishandlers zum Aufheben desHookings verwenden: -=.

Das Aufrufen dieser Methode hat keine Auswirkung, wenn keine Handler mit Kriterien registriert wurden, die den Eingabeparametern für den Methodenaufruf entsprechen.

Diese Methode ignoriert, ob handledEventsToo sich der Parameter true im AddHandler-Aufruf befand, der den Handler ursprünglich angefügt hat.

Weitere Informationen

• AddHandler(RoutedEvent, Object, Boolean)
• RoutedEvent
• Übersicht über Ereignisse und Routingereignisse