无废话WPF系列13：路由事件

逻辑树

<Window>
  <Grid>
    <Button>
      <StackPanel>
        <Image/>
        <TextBlock/>
      </StackPanel>
    </Button>
  </Grid>
</Window>

但是实际上这些元素在运行时会扩展为可是树

事件路由

对逻辑树和可视树有所了解很有必要，因为路由事件主要是根据可视树进行路由。路由事件支持三种路由策略：气泡、隧道和直接。

气泡事件最为常见，它表示事件从源元素扩散（传播）到可视树，直到它被处理或到达根元素。这样您就可以针对源元素的上方层级对象处理事件。例如，您可向嵌入的 Grid 元素附加一个 Button.Click 处理程序，而不是直接将其附加到按钮本身。气泡事件有指示其操作的名称（例如，MouseDown）。

隧道事件采用另一种方式，从根元素开始，向下遍历元素树，直到被处理或到达事件的源元素。这样上游元素就可以在事件到达源元素之前先行截取并进行处理。根据命名惯例，隧道事件带有前缀 Preview（例如 PreviewMouseDown）。

直接事件类似 .NET Framework 中的正常事件。该事件唯一可能的处理程序是与其挂接的委托。

通常，如果为特殊事件定义了隧道事件，就会有相应的气泡事件。在这种情况下，隧道事件先触发，从根元素开始，下行至源元素，查找处理程序。一旦它被处理或到达源元素，即会触发气泡事件，从源元素上行，查找处理程序。气泡或隧道事件不会仅因调用事件处理程序而停止路由。如果您想中止隧道或气泡进程，可使用您传递的事件参数在事件处理程序中将事件标记为已处理。

示例(我们在Grid上加了一个Button.Click的附加事件:

<Window x:Class="DeepXAML.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:local="clr-namespace:DeepXAML"       
        xmlns:sys="clr-namespace:System;assembly=mscorlib"
        Title="MainWindow" Height="250" Width="450">
    <Grid x:Name="rootGrid" Button.Click="rootGrid_Click">
        <Button x:Name="btnOK" Margin="30">OK</Button>
    </Grid>
</Window>

后台代码：

 private void rootGrid_Click(object sender, RoutedEventArgs e)
{
    MessageBox.Show((e.Source as FrameworkElement).Name); //btnOk
    MessageBox.Show((e.OriginalSource as FrameworkElement).Name); //btnOk
}

source是指LogicTree的源途，orginalSource指的是VisualTree上的源

自定义路由事件示例

<Window x:Class="DeepXAML.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:local="clr-namespace:DeepXAML"       
        xmlns:sys="clr-namespace:System;assembly=mscorlib"
        Title="MainWindow" Height="250" Width="450">
    <Grid x:Name="rootGrid" >
        <StackPanel x:Name="stp1" local:TestButton.ClickTimeEvent="TimeHanler">
            <StackPanel x:Name="stp2" local:TestButton.ClickTimeEvent="TimeHanler">
                <StackPanel x:Name="stp3" local:TestButton.ClickTimeEvent="TimeHanler">
                    <ListBox x:Name="listBox"></ListBox>
                    <local:TestButton local:TestButton.ClickTimeEvent="TimeHanler" Height="50" Margin="30">OK</local:TestButton>
                </StackPanel>
            </StackPanel>
        </StackPanel>       
    </Grid>
</Window>

后台代码

using System;
using System.Collections.Generic;
using System.Windows;
using System.Windows.Data;
using System.Windows.Documents;
using System.Windows.Controls;

namespace DeepXAML
{
    public partial class MainWindow : Window
    {
        public MainWindow()
        {
            InitializeComponent();
    
        }

        private void TimeHanler(object sender, TimeEventArgs e)
        {
            FrameworkElement element = sender as FrameworkElement;
            string strTime = e.ClickTime.ToLongTimeString();
            this.listBox.Items.Add( element.Name+":"+ strTime);
        }              
    }

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

    public class TestButton : Button
    { 
      public static RoutedEvent timeEvent=
          EventManager.RegisterRoutedEvent("ClickTimeEvent", RoutingStrategy.Bubble, typeof(EventHandler<TimeEventArgs>), typeof(TestButton));

        public event  RoutedEventHandler ClickTimeEvent
        {
          add {this.AddHandler(timeEvent,value);}
          remove{this.RemoveHandler(timeEvent,value);}
        }

        protected override void  OnClick()
        {
              base.OnClick();
            TimeEventArgs args=new TimeEventArgs(timeEvent,this);
            args.ClickTime=DateTime.UtcNow;
            this.RaiseEvent(args);
        }
    }    
}