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, ke kterému je připojena obslužná rutina události.

e

RoutedEventArgs

Data události

Poznámky

Delegát se RoutedEventHandler 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.

Nejpozoruhodnějším rozdílem mezi zápisem obslužné rutiny pro směrovanou událost oproti obecné události clR (Common Language Runtime) je to, že sender událost události (prvek, ke kterému je obslužná rutina připojena a vyvolána) nelze považovat za zdroj události. Zdroj je hlášen jako vlastnost v datech události (Source). Rozdíl mezi sender a Source je výsledkem směrování události do různých prvků během procházení směrované události stromem prvků.

Pokud se záměrně nezajímáte o chování směrování přímé nebo bublající směrované události a máte v úmyslu zpracovávat směrované události pouze u prvků, kde jsou poprvé vyvolány, můžete použít buď senderSource nebo pro odkaz na objekt. Za těchto okolností sender a Source jsou stejným objektem.

Pokud chcete využít základní funkce směrovaných událostí a odpovídajícím způsobem zapsat obslužné rutiny, jsou dvě nejdůležitější vlastnosti dat událostí, se kterými budete při psaní obslužných Source rutin událostí pracovat, a Handled.

U určitých kombinací vstupních událostí a tříd ovládacích prvků WPF není prvek, který vyvolává událost, prvním prvkem, který má možnost ji zpracovat. Pokud má vstupní událost verzi Preview události, má kořen stromu elementů první příležitost, může ve sdílených datech události nastavit Handled na true a může ovlivnit, jak je vstupní událost hlášena zbývajícím prvkům ve své trase události. Chování zpracování náhledu může dát zdání, že konkrétní směrovaná událost není vyvolána podle očekávání. Další informace najdete v tématu Přehled událostí ve verzi Preview a vstupu.

Metody rozšíření