WPF路由事件

理解路由事件

事件路由允許源自某個元素的事件由另一個元素引發。

定義、註冊和包裝路由事件

public class MyWindow : Window
{
	/// <summary>
	/// 定義和註冊路由事件
	/// </summary>
	public static readonly RoutedEvent MyRoutedEvent = EventManager.RegisterRoutedEvent("MyEvent",
		RoutingStrategy.Bubble, typeof(RoutedEventHandler), typeof(MyWindow));

	/// <summary>
	/// 包裝路由事件
	/// </summary>
	public event RoutedEventHandler MyRouted
	{
		add
		{
			base.AddHandler(MyRoutedEvent, value);
		}
		remove
		{
			base.RemoveHandler(MyRoutedEvent, value);
		}
	}
}

共用路由事件

​ 與依賴項屬性一樣，可以在類之間共用路由事件的定義。例如，兩個基類UIElement和ContentElement類,都使用了MouseUp事件。MouseUp事件是在Windows.Input.Mouse類中定義，通過RoutedEvent.AddOwer()方法重用MouseUp事件。

	UIElement.MouseUpEvent = Mouse.MouseUpEvent.AddOwner(Typeof(UIElement));

觸發路由事件

路由事件的引發不是傳統的.NET事件包裝器引發，而是使用RaiseEvent()方法引發事件，說有UIElement類繼承了該方法。

	RoutedEventArgs e = new RoutedEventArgs(MyRoutedEvent, this);
	base.RaiseEvent(e);

處理路由事件

XAML標記添加事件特性

<local:MyWindow ... 
                MyRouted="MyWindow_MyRouted"
                ... />

通過代碼連接事件

     this.MyRouted += MainWindow_MyRouted;

	///WPF事件參數類都是繼承自RoutedEventArgs類，可自定義事件參數類來傳遞更多的信息
	private void MainWindow_MyRouted(object sender, RoutedEventArgs e)
	{
		//do something...
	}

還可以通過調用AddHandler()方法鏈接事件處理器。

	AddHandler(MyRoutedEvent, new RoutedEventHandler((s,e)=>
	{
        //do something...                                                 
	}));	
	或
	AddHandler(MyRoutedEvent, new RoutedEventHandler(Eventhandler));

	private void Eventhandler(object o, RoutedEventArgs e)
	{
		//do something...
	}
	//使用RemoveHandler()方法來移除事件處理器 註：匿名委托不適用
	//當程式多次附加事件處理器時，執行RemoveHandler()方法只刪除一次連接。例如，連接了兩次事件處理程式，刪除了一次連接，觸發事件時事件處理程式執行一次。		連接了三次事件處理程式，刪除了一次連接，觸發事件時事件處理程式執行兩次。
	RemoveHandler(MyRoutedEvent, new RoutedEventHandler(eventhandler));
	或
     MyRouted -= Eventhandler;

事件路由

WPF窗體中的所有要素都一定程度上繼承自UIElement類，WPF中的許多空間都是內容控制項，繼承自ContentControl，可以在其中多次重覆嵌套。

WPF路由事件模型的三種方式：

• 直接路由事件(Direct Event)：與.NET事件類似，它起源於一個元素，並且不傳遞給其他元素。例如，MouseEnter事件是一個直接路由事件。
• 冒泡路由事件(Bubbling Event)：在包含層次中向上傳遞。例如，MouseDown事件就是冒泡路由事件。冒泡順序首先由被單擊的元素引發，接下來被該元素的父元素引發，依次類推，直到WPF元素樹的頂部為止。
• 隧道路由事件(Tunneling Event)：在包含層次中向下傳遞。隧道路由事件在事件到達恰當的控制項之前為預覽事件（或者可能終止事件）提供機會。例如，通過PreviewKeyDown事件可以截獲是否按下了一個鍵，首先在視窗級別上，然後是更具體的容器，直到到達按下鍵時具有焦點的元素。

路由事件的行為在註冊路由事件的EventManager.RegisterEvent()中定義，傳遞為RoutingStrategy枚舉值。

RoutedEventArgs類

WPF事件參數類都是繼承自RoutedEventArgs類，可自定義事件參數類來傳遞更多的信息。RoutedEventArgs類的屬性：

冒泡路由事件

<Label MouseUp="Label_MouseUp">
	<Border MouseUp="Border_MouseUp">
		<StackPanel MouseUp="StackPanel_MouseUp">
			<Button Width="100" Height="30"  MouseUp="Button_MouseUp"/>
		</StackPanel>
	</Border>
</Label>

MessageBox.Show("btn"+"\n"+sender.ToString()+ "\n" + e.Source.ToString()+ "\n" + e.OriginalSource.ToString());

在一個容器中放置下列元素，分別給每一個元素的MouseUp事件處理器添加以上代碼。窗體打開後右鍵點擊按鈕就會依次彈出消息框，通過消息框信息可以看到事件的觸發順序依次是Button、StackPanel、Border、Label。若在StackPanel的MouseUp事件處理器中將e.Handled設置為true時，事件將不會繼續傳播，程式將不會在進入Boder和Label中的MouseUp事件處理器中。

e.Handled = true;

當事件處於掛起時，還可以通過AddHandler()方法，AddHandler()方法提供一個重載版本，在之前的基礎上在傳遞一個bool類型的參數，將參數設置為true時，即使Handled屬性被設置為true也可以接收到事件。

lab.AddHandler(UIElement.MouseUpEvent, new MouseButtonEventHandler(Label_MouseUp), true);

在設計器中刪除Label元素的MouseUp事件特性，在初始化時通過以上代碼連接事件處理器。當觸發MouseUp時，Label消息框就會出現。

附加事件

<StackPanel Name="stpBtn" Grid.Row="2" ButtonBase.Click="DoSomething">
	<Button Width="100" Height="30" />
	<Button Width="100" Height="30" Margin="0,10" />
	<Button Width="100" Height="30" />
</StackPanel>

以上代碼在StackPanel元素中關聯Button元素的點擊事件，當點擊其中按鈕時就會進圖DoSomething()方法，通過類名.事件命關聯事件。Click事件是在ButtonBase中定義，Button繼承自ButtonBase。附加事件還可以通過以下方式連接：

//關聯附加事件只能用UIElement.AddHandler()方法 不能用 += 運算符
stpBtn.AddHandler(Button.ClickEvent, new RoutedEventHandler(DoSomething));

隧道事件

隧道路由事件的工作方式和冒泡路由事件相同，但方向相反。隧道路由事件一般有Preview開頭，WPF通常成對的定義隧道路由事件通常和冒泡事件。如果將隧道路由事件標記為已處理過（e.Handled=true），那麼就不會發生冒泡路由事件，這是因為兩個事件共用RoutedEventArgs的同一個實例。

WPF事件

WPF元素提供了許多事件，但最重要的事件通常包括5類，生命周期事件、滑鼠事件、鍵盤事件、手寫筆事件、多點觸控事件。