UIElement.RemoveHandler(RoutedEvent, Object) Método

Definição

Namespace:

Windows.UI.Xaml

Remove o manipulador de eventos roteado especificado desse UIElement. Normalmente, o manipulador em questão foi adicionado por AddHandler.

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)

Parâmetros

routedEvent

RoutedEvent

O identificador do evento roteado ao qual o manipulador está anexado.

handler

Object

Platform::Object

IInspectable

A implementação específica do manipulador a ser removida da coleção de manipuladores de eventos nesta UIElement.

Comentários

RemoveHandler só pode ser usado para os manipuladores de eventos com suporte do AddHandler, que são aproximadamente os eventos específicos de entrada de UIElement. Mais precisamente, o evento deve ter uma propriedade *Event do tipo RoutedEvent, que é verdadeira apenas de determinados eventos em UIElement. Não é possível usar RemoveHandler para desafogar manipuladores de eventos para eventos Windows Runtime em instâncias de classe de runtime em geral. Em vez disso, você deve usar a sintaxe de unhooking do manipulador de eventos específico:

• -= em C#
• RemoveHandler no Microsoft Visual Basic
• -= em extensões de componente do Visual C++ (C++/CX)

Chamar esse método não terá efeito se não houver manipuladores registrados com critérios que correspondam aos parâmetros de entrada para a chamada de método.

Esse método ignora se o parâmetro handledEventsToo era true na chamada AddHandler que originalmente anexava o manipulador.

Confira também

• AddHandler(RoutedEvent, Object, Boolean)
• RoutedEvent
• Visão geral de eventos e eventos roteados