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类的属性：

名称	说明
Source	指示引发事件的对象。对于键盘事件，是当事件发生时具有焦点的控件。对于鼠标事件，是当事件发生时鼠标指针下面所有元素中最上面的元素。
OriginalSource	指示最初是什么对象引发事件。通常OriginalSource属性和Source属性值是相同的。但是在某些情况下，OriginalSource属性指向对象树种更深得层次，以获得作为更高一级元素一部分的后台元素，事件最原始的源为Border元素，组成在控件模板中。
RoutedEvent	通过事件处理程序为触发的事件提供RoutedEvent对象。如果使用同一事件处理程序处理不同的事件，这一信息是非常有用得。
Handled	该属性允许终止事件的冒泡或隧道过程。如果一个控件将Handled属性设置为true，那么事件将不会继续传播。并且也不会再为任何其他元素引发该事件。

冒泡路由事件

<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类，生命周期事件、鼠标事件、键盘事件、手写笔事件、多点触控事件。