EventManager.RegisterClassHandler Метод

public:
 static void RegisterClassHandler(Type ^ classType, System::Windows::RoutedEvent ^ routedEvent, Delegate ^ handler);

public static void RegisterClassHandler (Type classType, System.Windows.RoutedEvent routedEvent, Delegate handler);

static member RegisterClassHandler : Type * System.Windows.RoutedEvent * Delegate -> unit

Public Shared Sub RegisterClassHandler (classType As Type, routedEvent As RoutedEvent, handler As Delegate)

Параметры

Примеры

В следующем примере добавляется обработчик для PreviewMouseRightButtonDownEvent, вызывая RegisterClassHandler.

static MyEditContainer()
{
  EventManager.RegisterClassHandler(typeof(MyEditContainer), PreviewMouseRightButtonDownEvent, new RoutedEventHandler(LocalOnMouseRightButtonDown));
}
internal static void LocalOnMouseRightButtonDown(object sender, RoutedEventArgs e)
{
  MessageBox.Show("this is invoked before the On* class handler on UIElement");
  //e.Handled = true; //uncommenting this would cause ONLY the subclass' class handler to respond
}

Shared Sub New()
  EventManager.RegisterClassHandler(GetType(MyEditContainer), PreviewMouseRightButtonDownEvent, New RoutedEventHandler(AddressOf LocalOnMouseRightButtonDown))
End Sub
Friend Shared Sub LocalOnMouseRightButtonDown(ByVal sender As Object, ByVal e As RoutedEventArgs)
  MessageBox.Show("this is invoked before the On* class handler on UIElement")
  'e.Handled = True //uncommenting this would cause ONLY the subclass' class handler to respond
End Sub

Комментарии

Обработка классов — это функция, доступная для перенаправленных событий, включая присоединенные события, реализованные с поддержкой перенаправленных событий. Обработчик класса похож на статический обработчик, который существует для всех экземпляров класса . Так как обработчик является статическим, нельзя изменять свойства экземпляра напрямую с помощью обработчика класса, но доступ к экземплярам можно получить с помощью sender параметра и (или) данных события.

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

Многие события базового элемента WPF обеспечивают обработку виртуальных методов класса. Переопределяя эти методы в классах, наследующих базовые классы, можно реализовать обработку классов без вызова RegisterClassHandler в статических конструкторах. Эти методы обработки классов обычно существуют для входных событий и имеют имена, начинающиеся с "On" и заканчивающиеся именем обрабатываемого класса события.

Дополнительные сведения об обработке классов см. в разделах Маркировка перенаправленных событий как обработанных и Обработка классов.

С помощью этой сигнатуры обработчики классов будут зарегистрированы для вызова только в ответ на необработанные события. Можно также зарегистрировать обработчики классов для вызова, даже если аргументы события помечены как обрабатываемые с помощью сигнатуры RegisterClassHandler(Type, RoutedEvent, Delegate, Boolean) , для handledEventsToo которых задано значение true.

public:
 static void RegisterClassHandler(Type ^ classType, System::Windows::RoutedEvent ^ routedEvent, Delegate ^ handler, bool handledEventsToo);

public static void RegisterClassHandler (Type classType, System.Windows.RoutedEvent routedEvent, Delegate handler, bool handledEventsToo);

static member RegisterClassHandler : Type * System.Windows.RoutedEvent * Delegate * bool -> unit

Public Shared Sub RegisterClassHandler (classType As Type, routedEvent As RoutedEvent, handler As Delegate, handledEventsToo As Boolean)

Параметры

Комментарии

Обработка классов — это функция, доступная для перенаправленных событий, включая присоединенные события, реализованные с поддержкой перенаправленных событий. Обработчик класса похож на статический обработчик, который существует для всех экземпляров класса . Так как обработчик является статическим, нельзя изменять свойства экземпляра напрямую с помощью обработчика класса, но доступ к экземплярам можно получить с помощью sender параметра и (или) данных события.

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

Многие события базового элемента WPF обеспечивают обработку виртуальных методов класса. Переопределяя эти методы в классах, наследующих базовые классы, можно реализовать обработку классов без вызова RegisterClassHandler в статических конструкторах. Эти методы обработки классов обычно существуют для входных событий и имеют имена, начинающиеся с "On" и заканчивающиеся именем обрабатываемого класса события.

Дополнительные сведения об обработке классов см. в разделах Маркировка перенаправленных событий как обработанных и Обработка классов.

Используя эту сигнатуру, обработчики классов можно зарегистрировать для вызова при обработке событий, задав для handledEventsToo параметра значение true. Как правило, это следует делать только в том случае, если есть известная проблема обработки, с помощью которых вы пытаетесь обойтись, например, система ввода обрабатывает события мыши или клавиатуры.