RoutedEventHandler 代理人

定義

命名空間:

System.Windows

組件:

PresentationCore.dll

表示方法，這個方法會針對其特定事件資料不超過所有路由事件共通資料範圍的各種路由事件進行處理。

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

附加事件處理常式的物件。

e

RoutedEventArgs

事件資料。

備註

委派 RoutedEventHandler 用於未報告事件資料中事件特定資訊的任何路由事件。 有許多這類路由事件;醒目範例包括 Click 和 Loaded 。

撰寫路由事件的處理常式與一般 Common Language Runtime (CLR) 事件之間最值得注意的差異在於， sender 事件 (附加處理常式並叫用) 不一定是事件的來源。 來源會回報為事件資料中的屬性， Source () 。 和 Source 之間的差異 sender 是在透過專案樹狀結構周遊路由事件期間，將事件路由傳送至不同專案的結果。

如果您刻意不想要直接或反升路由事件的路由行為，而且您只想處理第一次引發路由事件之元素上的路由事件，則可以使用 sender 或 Source 作為物件參考。 在此情況下， sender 和 Source 是相同的物件。

如果您想要利用路由事件的固有功能，並據以寫入處理常式，則撰寫事件處理常式時，您將使用的事件資料兩個最重要的屬性是 Source 和 Handled 。

對於輸入事件和 WPF 控制項類別的特定組合，引發事件的元素不是有機會處理事件的第一個專案。 如果輸入事件具有事件的預覽版本，則元素樹狀結構的根目錄第一個機會、可以在共用事件資料中設定 Handled 為 true ，並會影響輸入事件回報至其事件路由中剩餘元素的方式。 預覽處理行為可以提供特定路由事件未如預期引發的外觀。 如需詳細資訊，請參閱 預覽事件 和 輸入概觀。

擴充方法