UIElement.AddHandler Метод

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)

Параметры

Реализации

Комментарии

Вы можете добавить один и тот же обработчик для одного и того же события несколько раз, не вызывая исключения. Однако обработчик фактически вызывается несколько раз при обработке события. Поэтому рассмотрим, как это поведение может иметь побочные эффекты, которые должны быть учтены в реализации обработчика.

Обычно этот метод используется для предоставления реализации метода доступа "add" для шаблона доступа к событиям Microsoft .NET пользовательского перенаправленного события.

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)

Параметры

Примеры

В следующем примере реализуется обработчик, вызываемый событием Initialized на странице, которая присоединяет определенный обработчик к одному из именованных элементов на странице с помощью handledEventsTootrue. Этот обработчик вызывается даже в том случае, если другой элемент по маршруту помечает общие данные события, которые обрабатываются перед достижением элемента обработки в маршруте.

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

Комментарии

Обработка низкоуровневых событий ввода практически является сложной задачей. Многие элементы управления реализуют поведение, в котором определенное событие помечается как обработанное, и заменяется другим более интуитивно понятным событием. Как правило, элемент управления помечает только событие ввода платформы как обработанное, если для этого существует некоторое намерение разработки. В некоторых сценариях эти намерения проектирования могут не быть тем, что требуется для конкретной обработки события ввода. Для этих сценариев регистрирование обработчиков с помощью handledEventsToo в соответствии с true подходит. Но вы не должны делать это регулярно. Вызов обработчиков в ответ на все события, даже если обработка будет усложнять собственную логику обработки событий приложения. Если логика обработчика является существенной, может возникнуть снижение производительности. Следует зарезервировать использование обработчиков подключения для уже обработанных событий для ситуаций, когда вы уже обнаружили во время процесса разработки, которые некоторые элементы управления обрабатывают события, которые по-прежнему нужно обрабатывать с помощью логики приложения.

Другой способ предотвращения поведения обработки класса определенных сочетаний элементов управления событиями — использовать альтернативу предварительной версии этого события. Например, если MouseLeftButtonDown помечается обработкой классов, можно добавить обработчики для PreviewMouseLeftButtonDown.

Вы можете добавить один и тот же обработчик для одного и того же события несколько раз, не вызывая исключения. Однако обработчик фактически вызывается несколько раз при обработке события. Поэтому рассмотрим, как это поведение может иметь побочные эффекты, которые должны быть учтены в реализации обработчика.

Обычно этот метод используется для предоставления реализации метода доступа "add" для шаблона доступа к событиям Microsoft .NET пользовательского перенаправленного события.