RoutedEventHandler Delegat

Definicja

Reprezentuje metodę, która będzie obsługiwać różne zdarzenia kierowane, które nie mają określonych danych zdarzeń poza danymi, które są wspólne dla wszystkich zdarzeń kierowanych.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)

Parametry

sender
Object

Obiekt, do którego jest dołączona procedura obsługi zdarzeń.The object where the event handler is attached.

e
RoutedEventArgs

Dane dotyczące zdarzenia.The event data.

Uwagi

RoutedEventHandlerDelegat jest używany dla wszystkich zdarzeń kierowanych, które nie zgłaszają informacji specyficznych dla zdarzenia w danych zdarzenia.The RoutedEventHandler delegate is used for any routed event that does not report event-specific information in the event data. Istnieje wiele takich zdarzeń kierowanych; widoczne przykłady obejmują Click i Loaded .There are many such routed events; prominent examples include Click and Loaded.

Najbardziej istotna różnica między pisaniem procedury obsługi dla zdarzenia kierowanego w przeciwieństwie do ogólnego zdarzenia środowiska uruchomieniowego języka wspólnego (CLR) polega na tym, że sender zdarzenie (element, do którego jest dołączona i wywołana procedura obsługi) nie może być uważane za źródło zdarzenia.The most noteworthy difference between writing a handler for a routed event as opposed to a general common 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. Źródło jest raportowane jako właściwość w danych zdarzenia ( Source ).The source is reported as a property in the event data (Source). Różnica między sender i Source jest wynikiem zdarzenia kierowanego do różnych elementów podczas przechodzenia zdarzenia kierowanego za pomocą drzewa elementu.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.

Można użyć sender lub Source dla odwołania do obiektu, jeśli celowo nie interesuje się zachowanie routingu bezpośredniego lub propagacji zdarzenia kierowanego i tylko do obsługi zdarzeń kierowanych do elementów, w których są one po raz pierwszy zgłoszone.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. W tej sytuacji sender i Source są tego samego obiektu.In this circumstance, sender and Source are the same object.

Jeśli zamierzasz korzystać z funkcji zdarzeń kierowanych na trasie i napisać odpowiednie procedury obsługi, dwie najważniejsze właściwości danych zdarzenia, z którymi będziesz korzystać podczas pisania obsługi zdarzeń, są Source i 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.

W przypadku niektórych kombinacji zdarzeń wejściowych i klas formantów WPF element, który wywołuje zdarzenie, nie jest pierwszym elementem, który ma możliwość ich obsługi.For certain combinations of input events and WPF control classes, the element that raises the event is not the first element that has the opportunity to handle it. Jeśli zdarzenie wejściowe ma wersję zapoznawczą zdarzenia, katalog główny drzewa elementu ma pierwszą szansę, może być ustawiony na wartość Handled true w danych zdarzenia udostępnionego i może wpływać na to, jak zdarzenie wejściowe jest raportowane do pozostałych elementów w swojej marszrucie zdarzeń.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. Zachowanie obsługi podglądu może dać wrażenie, że określone zdarzenie kierowane nie jest wywoływane zgodnie z oczekiwaniami.The Preview handling behavior can give the appearance that a particular routed event is not raised as expected. Aby uzyskać więcej informacji, zobacz temat Podgląd zdarzeń i dane wejściowe.For more information, see Preview Events and Input Overview.

Metody rozszerzania

GetMethodInfo(Delegate)

Pobiera obiekt, który reprezentuje metodę reprezentowaną przez określony delegat.Gets an object that represents the method represented by the specified delegate.

Dotyczy