RoutedEventHandler Delegat

Definicja

Przestrzeń nazw:

System.Windows

Zestaw:

PresentationCore.dll

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.

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, w którym jest dołączony program obsługi zdarzeń.

e

RoutedEventArgs

Dane dotyczące zdarzenia.

Uwagi

Delegat RoutedEventHandler jest używany dla dowolnego zdarzenia kierowanego, które nie zgłasza informacji specyficznych dla zdarzenia w danych zdarzenia. Istnieje wiele takich zdarzeń kierowanych; przykłady to m.in. Click i Loaded.

Najbardziej godna uwagi różnica między pisaniem programu obsługi dla zdarzenia kierowanego, a nie ogólnego zdarzenia środowiska uruchomieniowego języka wspólnego (CLR), jest to, że sender zdarzenie (element, w którym program obsługi jest dołączony i wywoływany) nie może być uważane za źródło zdarzenia. Źródło jest zgłaszane jako właściwość w danych zdarzenia (Source). Różnica między elementami sender i Source jest wynikiem kierowania zdarzenia do różnych elementów podczas przechodzenia zdarzenia kierowanego przez drzewo elementów.

Można użyć odwołania sender do obiektu lub Source , jeśli celowo nie interesuje Cię zachowanie routingu zdarzenia kierowanego bezpośrednio lub bubbling i zamierzasz obsługiwać tylko kierowane zdarzenia na elementach, w których są one zgłaszane po raz pierwszy. W tej sytuacji sender i Source są tym samym obiektem.

Jeśli zamierzasz korzystać z funkcji związanych z kierowanymi zdarzeniami i odpowiednio zapisywać programy obsługi, dwie najważniejsze właściwości danych zdarzenia, z którymi będziesz pracować podczas pisania procedur obsługi zdarzeń, to Source i Handled.

W przypadku niektórych kombinacji zdarzeń wejściowych i klas kontrolek WPF element, który zgłasza zdarzenie, nie jest pierwszym elementem, który ma możliwość jego obsługi. Jeśli zdarzenie wejściowe ma wersję zapoznawcza zdarzenia, katalog główny drzewa elementów ma pierwszą szansę sprzedaży, może ustawić wartość Handledtrue na wartość w udostępnionych danych zdarzenia i może wpływać na sposób raportowania zdarzenia wejściowego do pozostałych elementów w trasie zdarzenia. Zachowanie obsługi wersji zapoznawczej może dać wygląd, że określone zdarzenie kierowane nie jest zgłaszane zgodnie z oczekiwaniami. Aby uzyskać więcej informacji, zobacz Podgląd zdarzeń i Przegląd danych wejściowych.

Metody rozszerzania