RoutedEventHandler Delegát

Definice

Obor názvů:

System.Windows

Sestavení:

PresentationCore.dll

Představuje metodu, která bude zpracovávat různé směrované události, které nemají konkrétní data událostí nad rámec dat, která jsou společná pro všechny směrované události.

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

Objekt, kde je připojena obslužná rutina události.

e

RoutedEventArgs

Data události

Poznámky

Delegát RoutedEventHandler se používá pro všechny směrované události, které nehlásí informace specifické pro událost v datech události. Existuje mnoho takových směrovaných událostí; mezi významné příklady patří Click a Loaded.

Nejdůležitější rozdíl mezi zápisem obslužné rutiny pro směrovanou událost na rozdíl od obecné události CLR (Common Language Runtime) je, že sender událost (prvek, ve kterém je obslužná rutina připojena a vyvolána), nelze považovat za nutně zdroj události. Zdroj je hlášen jako vlastnost v datech události (Source). Rozdíl mezi sender událostí a Source je výsledkem události směrované na různé prvky během procházení směrované události přes strom elementu.

Odkaz na objekt můžete použít sender buď nebo Source pro odkaz na objekt, pokud vás záměrně nezajímá chování směrování přímé nebo bublající směrované události a máte v úmyslu zpracovat pouze směrované události u prvků, ve kterých jsou poprvé vyvolány. V této situaci sender jsou stejné Source objekty.

Pokud máte v úmyslu využít výhod vlastních funkcí směrovaných událostí a odpovídajícím způsobem zapisovat obslužné rutiny, dva nejdůležitější vlastnosti dat události, se kterými budete pracovat při psaní obslužných rutin událostí jsou Source a Handled.

Pro určité kombinace vstupních událostí a WPF (Windows Presentation Foundation) třídy ovládacího prvku, který vyvolá událost, není prvním prvkem, který má příležitost zpracovat jej. Pokud má vstupní událost verzi Preview události, má kořen stromu elementů první příležitost, může nastavit Handled hodnotu true ve sdílených datech události a ovlivnit, jak se vstupní událost hlásí zbývajícím prvkům ve své trase události. Chování zpracování verze Preview může dát vzhled, že konkrétní směrovaná událost není vyvolána podle očekávání. Další informace najdete v tématu Náhled událostí a přehled vstupu.