RoutedEventHandler Делегат

Определение

Представляет метод, который будет обрабатывать различные перенаправленные события, не содержащие данных события, помимо тех, которые являются общими для всех перенаправленных событий.Represents the method that will handle various routed events that do not have specific event data beyond the data that is common for all routed events.

public delegate void RoutedEventHandler(System::Object ^ sender, RoutedEventArgs ^ e);
public delegate void RoutedEventHandler(object sender, RoutedEventArgs e);
type RoutedEventHandler = delegate of obj * RoutedEventArgs -> unit
Public Delegate Sub RoutedEventHandler(sender As Object, e As RoutedEventArgs)

Параметры

sender
Object

Объект, к которому присоединен обработчик событий.The object where the event handler is attached.

e
RoutedEventArgs

Данные события.The event data.

Наследование
RoutedEventHandler

Комментарии

RoutedEventHandler Делегат используется для любого перенаправленного события, которое не сообщает сведения о событии в данных о событии.The RoutedEventHandler delegate is used for any routed event that does not report event-specific information in the event data. Существует много таких перенаправленных событий; выразительное Click представление Loadedпримеров включает в себя и.There are many such routed events; prominent examples include Click and Loaded.

Наиболее значимая разница между написанием обработчика для перенаправленного события в отличие от общего среда CLRcommon language runtime (CLR) события заключается в том sender , что событие (элемент, в котором обработчик присоединяется и вызывается) не может считаться источником события.The most noteworthy difference between writing a handler for a routed event as opposed to a general среда CLRcommon language runtime (CLR) event is that the sender of the event (the element where the handler is attached and invoked) cannot be considered to necessarily be the source of the event. Источник указывается как свойство в данных события (Source).The source is reported as a property in the event data (Source). Разница между sender и Source является результатом события, которое направляется в различные элементы во время обхода перенаправленного события через дерево элементов.A difference between sender and Source is the result of the event being routed to different elements, during the traversal of the routed event through an element tree.

Можно использовать sender или Source для ссылки на объект, если намеренно не интересуется поведение маршрутизации прямого или восходящей перенаправленного события, и вы собираетесь обрабатывать перенаправленные события только в тех элементах, где они были впервые вызваны.You can use either sender or Source for an object reference if you are deliberately not interested in the routing behavior of a direct or bubbling routed event and you only intend to handle routed events on the elements where they are first raised. В этом случае sender и являются Source одним и тем же объектом.In this circumstance, sender and Source are the same object.

Если вы планируете воспользоваться преимуществами встроенных функций перенаправленных событий и записывали свои обработчики соответствующим образом, то при написании обработчиков Source Handledсобытий будут использоваться два наиболее важных свойства данных события, с которыми вы будете работать.If you do intend to take advantage of the inherent features of routed events and write your handlers accordingly, the two most important properties of the event data that you will work with when writing event handlers are Source and Handled.

Для некоторых сочетаний входных событий WPFWPF и классов элементов управления элемент, вызывающий событие, не является первым элементом, у которого есть возможность его справиться.For certain combinations of input events and WPFWPF control classes, the element that raises the event is not the first element that has the opportunity to handle it. Если событие ввода имеет предварительную версию события, то корневой элемент дерева элементов имеет первую возможность, может иметь значение Handled true в данных общего события и может влиять на то, как событие ввода передается оставшимся элементам в его маршруте события.If the input event has a Preview version of the event, then the root of the element tree has first opportunity, can set Handled to true in the shared event data, and can influence how the input event is reported to remaining elements in its event route. Режим обработки предварительной версии может дать представление о том, что определенное перенаправленное событие не порождается должным образом.The Preview handling behavior can give the appearance that a particular routed event is not raised as expected. Дополнительные сведения см. в статье Общие сведения о событиях предварительной версии и входных данных.For more information, see Preview Events and Input Overview.

Методы расширения

GetMethodInfo(Delegate)

Получает объект, представляющий метод, представленный указанным делегатом.Gets an object that represents the method represented by the specified delegate.

Применяется к