UIElement.RemoveHandler(RoutedEvent, Object) Methode

  • Referenz

Definition

Namespace:
Windows.UI.Xaml
Bearbeiten

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 in UIElement gilt. Sie können RemoveHandler nicht verwenden, um Ereignishandler für Windows-Runtime Ereignisse in Runtimeklasseninstanzen im Allgemeinen zu entfernen. Stattdessen sollten Sie die spezifische Ereignishandler-Enthookingsyntax verwenden:

  • -= in C#
  • RemoveHandler in Microsoft Visual Basic
  • -= in Visual C++-Komponentenerweiterungen (C++/CX)

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

Diese Methode ignoriert, ob der HandledEventsToo-Parameter im AddHandler-Aufruf, der ursprünglich dem Handler angefügt wurde, true war.

Gilt für:

Weitere Informationen