WPF中的路由事件 as U know，和以前Windows消息事件区别不再多讲，这篇博文中，将首先回顾下WPF内置的路由事件的用法，然后在此基础上自定义一个路由事件。
1.WPF内置路由事件
WPF中的大多数事件都是路由事件，WPF有3中路由策略：
具体不多讲，单需要注意的是WPF路由事件是沿着VIsualTree传递的。VisualTree与LogicalTree的区别在于：LogicalTree的叶子节点是构成用户界面的控件(xaml紧密相关)，而VisualTree要连控件中的细微结构也算上。VisualTree是LogicalTree的扩展。
reference: Understanding the Visual Tree and Logical Tree in WPF
下面给出一个使用WPF内置路由事件的例子：
<Window x:Class="WPFRoutedEvent.MainWindow"
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
Title="MainWindow" Height="350" Width="525" >
<Grid x:Name="Grid1" Margin="10" Background="AliceBlue" MouseLeftButtonDown="Grid1_MouseLeftButtonDown">
<StackPanel Background="BurlyWood" Height="200" x:Name="StackPanel1" Button.Click="ButtonInStackPanel_Click" MouseLeftButtonDown="StackPanel1_MouseLeftButtonDown">
<Button x:Name="Button1" Content="RoutedEvent" Click="Button1_Click" />
</StackPanel>
</Grid>
</Window>
using System.Windows;
using System.Windows.Controls;
using System.Windows.Input; namespace WPFRoutedEvent
{
/// <summary>
/// MainWindow.xaml 的交互逻辑
/// </summary>
public partial class MainWindow : Window
{
public MainWindow()
{
InitializeComponent();
//Grid订阅Button的Click事件
Grid1.AddHandler(Button.ClickEvent, new RoutedEventHandler(ButtonInGrid_Click));
} private void Button1_Click(object sender, RoutedEventArgs e)
{
MessageBox.Show("Button Clicked.");
//
//e.Handled = true;
} private void ButtonInStackPanel_Click(object sender, RoutedEventArgs e)
{
MessageBox.Show("StackPanel Clicked.");
} private void ButtonInGrid_Click(object sender, RoutedEventArgs e)
{
MessageBox.Show("Grid Clicked.");
} private void Grid1_MouseLeftButtonDown(object sender, MouseButtonEventArgs e)
{
MessageBox.Show("Grid Mouse Left button down.");
} private void StackPanel1_MouseLeftButtonDown(object sender, MouseButtonEventArgs e)
{
MessageBox.Show("StackPanel Mouse Left button down.");
}
}
}
Button的Click事件是一个路由事件，分别在StackPanel中和Grid中订阅这个事件并进行相应的处理，分别用xaml代码和C#代码如下：
Click="Button1_Click"
Button.Click="ButtonInStackPanel_Click"
Grid1.AddHandler(Button.ClickEvent, new RoutedEventHandler(ButtonInGrid_Click));
StackPanel的MouseLeftButtonDown也是一个路由事件,也可以叫“附加事件”。其实“附加事件”也是路由事件，只是个文字游戏，为什么还要另外起个名字呢？原来路由事件的宿主都是那些拥有可视化实体的界面元素；而附加事件则不具备显示在用户界面上的能力。
常见的附加事件有：
Binding类：SourceUpdated事件、TargetUpdated事件。
Mouse类：MouseEnter事件、MouseLeave事件、MouseDown事件、MouseUp事件等。
Keyboard类：KeyDown事件、KeyUp事件等。
Grid和StackPanel中均如下订阅：
MouseLeftButtonDown="StackPanel1_MouseLeftButtonDown"
程序运行如下：
2.自定义路由事件
前面DebugLZQ写过一篇博文，内容是关于自定义CLR事件的，参考：.NET自定义事件小结。下面来自定义一个WPF路由事件，各位博友可以比较下两者的异同。
创建自定义路由事件大体可以分为三个步骤：
(1)声明并注册路由事件
(2)为路由事件添加CLR事件包装
(3)创建可以激发路由事件的方法
下面我们自定义一个WPF路由事件，我们给事件携带个参数，为此需要创建一个RoutedEventArgs类的派生类。如下：
using System;
using System.Windows; namespace MyRoutedEvent
{
//事件参数
class ReportTimeRoutedEventArgs:RoutedEventArgs
{
public ReportTimeRoutedEventArgs(RoutedEvent routedEvent, object source) : base(routedEvent, source) { } public DateTime ClickTime { get; set; }
}
}
然后，创建一个Button类的派生类并按前面的步骤为其添加路由事件：
using System;
using System.Windows.Controls;
using System.Windows; namespace MyRoutedEvent
{
class TimeButton:Button
{
//声明和注册路由事件\
public static readonly RoutedEvent ReportTimeRoutedEvent =
EventManager.RegisterRoutedEvent("ReportTime", RoutingStrategy.Bubble, typeof(EventHandler<ReportTimeRoutedEventArgs>), typeof(TimeButton));
//CLR事件包装
public event RoutedEventHandler ReportTime
{
add { this.AddHandler(ReportTimeRoutedEvent, value); }
remove { this.RemoveHandler(ReportTimeRoutedEvent, value); }
}
//激发路由事件,借用Click事件的激发方法 protected override void OnClick()
{
base.OnClick();//保证Button原有功能正常使用，Click事件被激发 ReportTimeRoutedEventArgs args = new ReportTimeRoutedEventArgs(ReportTimeRoutedEvent, this);
args.ClickTime = DateTime.Now;
this.RaiseEvent(args);//UIElement及其派生类
} }
}
下面是程序界面的XAML代码，看下如何消费这个路由事件：
<Window x:Class="MyRoutedEvent.MainWindow"
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
xmlns:local="clr-namespace:MyRoutedEvent"
Title="MainWindow" Height="350" Width="525">
<Grid x:Name="grid1" local:TimeButton.ReportTime="TimeButton_ReportTime"><!---->
<Grid x:Name="grid2">
<Grid x:Name="grid3">
<StackPanel x:Name="stackPanel1">
<ListBox x:Name="listBox1"/>
<local:TimeButton Width="200" Height="200" Background="Aquamarine" ReportTime="TimeButton_ReportTime" /><!---->
</StackPanel>
</Grid>
</Grid>
</Grid>
</Window>
事件处理的后台代码如下：
using System.Windows; namespace MyRoutedEvent
{
/// <summary>
/// MainWindow.xaml 的交互逻辑
/// </summary>
public partial class MainWindow : Window
{
public MainWindow()
{
InitializeComponent();
} private void TimeButton_ReportTime(object sender, ReportTimeRoutedEventArgs e)//注意参数
{
listBox1.Items.Add(e.ClickTime.ToLongTimeString()+"DebugLZQ");
}
}
}
假如我如果想在后台代码中消费定义的路由事件，该如何做呢？
/// <summary>
/// MainWindow.xaml 的交互逻辑
/// </summary>
public partial class MainWindow : Window
{
public MainWindow()
{
InitializeComponent(); this.grid1.AddHandler(TimeButton.OnReportTimeRoutedEvent, new RoutedEventHandler(MainWindow_MEvent));
this.grid1.AddHandler(TimeButton.OnReportTimeRoutedEvent, new RoutedEventHandler(TimeButton_ReportTime1));//监听OnReportTimeRoutedEvent的路由事件 } private void TimeButton_ReportTime(object sender, ReportTimeRoutedEventArgs e)
{
listBox1.Items.Add(e.ClickTime.ToLongTimeString() + "DebugLZQ"); }
private void TimeButton_ReportTime1(object sender, RoutedEventArgs e)
{
ReportTimeRoutedEventArgs ss = e as ReportTimeRoutedEventArgs;//这里使用了一个转换，父类转换程子类的引用，只有转换了，才能被AddHandler调用。 listBox1.Items.Add(ss.ClickTime.ToLongTimeString() + "DebugLZQ"); }
void MainWindow_MEvent(object sender, RoutedEventArgs e)
{
MessageBox.Show("dddd");
}
}
程序运行效果如下：
小结：UIElement类是路由事件和附加事件的分水岭，因为从UIElement类开始才具备了再界面上显示的能力，也因为RaiseEvent、AddHandler和RemoveHandler这些方法也定义在UIElement类中。附加事件也只能算是路由事件的一种用法而不是一个新的概念，其本质还是路由事件。
