UIElement.AddHandler Método

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)

Parâmetros

Implementações

Comentários

Você pode adicionar o mesmo manipulador para o mesmo evento várias vezes sem gerar uma exceção. No entanto, o manipulador é invocado várias vezes quando o evento é tratado. Portanto, considere como esse comportamento pode ter efeitos colaterais que devem ser contabilizados na implementação do manipulador.

Normalmente, você usa esse método para fornecer a implementação do acessador "add" para o padrão de acesso a eventos do Microsoft .NET de um evento roteado personalizado.

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)

Parâmetros

Exemplos

O exemplo a seguir implementa um manipulador invocado no evento Initialized em uma página que anexa um manipulador definido a um dos elementos nomeados na página usando handledEventsTootrue. Esse manipulador seria invocado mesmo se outro elemento ao longo da rota marcasse os dados de evento compartilhados como manipulados antes de alcançar o elemento de tratamento na rota.

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

Comentários

Processar eventos de entrada de baixo nível de forma prática é uma tarefa complexa. Muitos controles implementam o comportamento em que um determinado evento é marcado como manipulado e é substituído por outro evento mais intuitivo. Em geral, um controle marcará apenas um evento de entrada de plataforma conforme tratado se houver alguma intenção de design para fazer isso. Em determinados cenários, essas intenções de design podem não ser o que seu tratamento específico do evento de entrada requer. É para esses cenários que o registro de manipuladores com handledEventsToo como true é apropriado. Mas você não deve fazer isso rotineiramente. Invocar manipuladores em resposta a todos os eventos, mesmo que manipulados, complicará sua própria lógica de processamento de eventos de aplicativo. Você poderá ver uma diminuição no desempenho se a lógica do manipulador for substancial. Você deve reservar o uso de manipuladores de anexação para eventos já manipulados para situações em que você já descobriu durante o processo de desenvolvimento que determinados controles estão tratando eventos que você ainda deseja lidar com a lógica do aplicativo.

Outra técnica para evitar o comportamento de manipulação de classe de determinadas combinações de controle de evento é usar a alternativa de visualização desse evento. Por exemplo, se MouseLeftButtonDown for marcado como manipulado pelo tratamento de classe, você poderá adicionar manipuladores para PreviewMouseLeftButtonDown em vez disso.

Você pode adicionar o mesmo manipulador para o mesmo evento várias vezes sem gerar uma exceção. No entanto, o manipulador é invocado várias vezes quando o evento é tratado. Portanto, considere como esse comportamento pode ter efeitos colaterais que devem ser contabilizados na implementação do manipulador.

Normalmente, você usa esse método para fornecer a implementação do acessador "add" para o padrão de acesso a eventos do Microsoft .NET de um evento roteado personalizado.