ContentElement.RemoveHandler(RoutedEvent, Delegate) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Remove o manipulador de eventos roteado especificado desse elemento.
public:
virtual void RemoveHandler(System::Windows::RoutedEvent ^ routedEvent, Delegate ^ handler);public void RemoveHandler(System.Windows.RoutedEvent routedEvent, Delegate handler);abstract member RemoveHandler : System.Windows.RoutedEvent * Delegate -> unit
override this.RemoveHandler : System.Windows.RoutedEvent * Delegate -> unitPublic Sub RemoveHandler (routedEvent As RoutedEvent, handler As Delegate)Parâmetros
- routedEvent
- RoutedEvent
O identificador do evento.routed para o qual o manipulador está anexado.
- handler
- Delegate
A implementação específica do manipulador a ser removida da coleção de manipuladores de eventos nesse elemento.
Implementações
Comentários
O cenário mais comum para usar essa API é quando você implementa o evento "wrapper" clr (common language runtime) associado a um evento roteado personalizado, especificamente quando você implementa a lógica "remove" para manipuladores no nível clr. O exemplo que segue esta seção de comentários ilustra esse cenário.
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.
Se mais de um manipulador for anexado que corresponda aos critérios, somente o primeiro manipulador no repositório de manipuladores de eventos será removido. Esse comportamento é consistente com o comportamento CLR do -= operador.
Nem routedEvent nem handler pode ser null. A tentativa de fornecer um valor como null gerará uma exceção.
Esse método ignora as informações de handledEventsToo parâmetro, que são fornecidas se o manipulador foi adicionado pela primeira vez com a assinatura que permite o AddHandler(RoutedEvent, Delegate, Boolean) tratamento de eventos já tratados. Qualquer tipo de manipulador é removido.