自定义路由事件

创建自定义路由事件大体分为三个步骤：
（1）、声明并注册路由事件。
（2）、为路由事件添加CLR事件包装。
（3）、创建可以激发路由事件的方法。

下面用一个例子来展示这个过程：
首先创建一个RoutedEventArgs类的派生类，并为其添加ClickTime属性：

public class ReportTimeEventArgs : RoutedEventArgs{    public ReportTimeEventArgs(RoutedEvent routedEvent, object source)        : base(routedEvent, source) { }    public DateTime ClickTime { get; set; }}

然后创建一个Button类的派生类并按前述步骤为其添加路由事件：

public class TimeButton : Button{    //声明和注册路由事件    public static readonly RoutedEvent ReportTimeEvent = EventManager.RegisterRoutedEvent        ("ReportTime", RoutingStrategy.Bubble, typeof(EventHandler<ReportTimeEventArgs>), typeof(TimeButton));    //CLR时间包装器    public event RoutedEventHandler ReportTime    {        add { this.AddHandler(ReportTimeEvent, value); }        remove { this.RemoveHandler(ReportTimeEvent, value); }    }    //激发路由事件，借用Click事件的激发方法    protected override void OnClick()    {        base.OnClick();     //保证Button原有功能正常使用、Click事件能被激发        ReportTimeEventArgs args = new ReportTimeEventArgs(ReportTimeEvent, this);        args.ClickTime = DateTime.Now;        this.RaiseEvent(args);    }}

界面的XAML代码：

<Window x:Class="WpfWindows8.Window8_3_2"        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"        xmlns:d="http://schemas.microsoft.com/expression/blend/2008"        xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"        xmlns:local="clr-namespace:WpfWindows8"        xmlns:localModel="clr-namespace:WpfWindows8.Model"        mc:Ignorable="d"        Title="Routed Event" x:Name="window8_3_2" Height="300" Width="300"        localModel:TimeButton.ReportTime="ReportTimeHandler">    <Grid x:Name="grid_1" localModel:TimeButton.ReportTime="ReportTimeHandler">        <Grid x:Name="grid_2" localModel:TimeButton.ReportTime="ReportTimeHandler">            <Grid x:Name="grid_3" localModel:TimeButton.ReportTime="ReportTimeHandler">                <StackPanel x:Name="stackPanel_1"                            localModel:TimeButton.ReportTime="ReportTimeHandler">                    <ListBox x:Name="listBox"/>                    <localModel:TimeButton x:Name="timeButton" Width="80" Height="80"                                           Content="报时" localModel:TimeButton.ReportTime="ReportTimeHandler"/>                </StackPanel>            </Grid>        </Grid>    </Grid></Window>

ReportTimeHandler的代码如下：

     private void ReportTimeHandler(object sender, ReportTimeEventArgs e)        {            FrameworkElement element = sender as FrameworkElement;            string timeStr = e.ClickTime.ToLongTimeString();            string content = string.Format("{0} 到达 {1}", timeStr, element.Name);            this.listBox.Items.Add(content);        }

运行结果如下

声明并注册路由事件

public static readonly RoutedEvent ReportTimeEvent = EventManager.RegisterRoutedEvent            ("ReportTime", RoutingStrategy.Bubble, typeof(EventHandler<ReportTimeEventArgs>), typeof(TimeButton));

EventManager.RegisterRoutedEvent方法有四个参数，含义分别为：
第一个参数string类型，被称为路由事件的名称，一般为RoutedEvent变量的前缀和CLR事件包装器的名称一致。
第二个参数为路由事件的策略。WPF路由事件有3种策略：
1.Bubble，冒泡式：路由事件由事件激发者出发向它上级容器一层一层路由，直至最外层容器。
2.Tunnel，隧道式：事件的路由方向正好与Bubble策略相反，由UI树的树根向事件激发控件移动。
3.Direct，直达式：模仿CLR直接事件，直接将事件消息送达事件处理器。
第三个参数用于指定事件处理器类型。
第四个参数用于指名路由事件的宿主（拥有者）是哪个类型。这个类型与第一个参数共同参与一些底层算法产生这个路由事件的Hash Code并注册到程序的路由事件列表中。