《WPF程序设计指南》读书笔记——第9章 路由输入事件

1.使用路由事件

    路由事件是一种可以针对元素树中的多个侦听器（而不是仅针对引发该事件的对象）调用处理程序的事件。通俗地说，路由事件会在可视树（逻辑树是其子集）上，上下routed，如果哪个节点上订阅了事件，就会被触发。

    路由事件的规则有三种：

    （1）冒泡；由事件源向上沿视觉树传递一直到根元素。如 MouseDown

    （2）直接；只有事件源才有机会响应事件，某个元素引发事件后，不传递到其他元素

    （3）隧道；从元素树的根部调用事件处理程序并依次向下深入直到事件源。 一般情况下，WPF提供的输入事件都是以隧道/冒泡对实现的。隧道事件常常被称为Preview事件。如 PreviewMouseDown

    可以通过 e.handled = true 来停止路由。

using System;
using System.Windows;
using System.Windows.Controls;
using System.Windows.Input;
using System.Windows.Media;
using System.Windows.Documents;

namespace LY.ExamineRoutedEvents
{
    public class ExamineRoutedEvents : Application
    {
        static readonly FontFamily fontfam = new FontFamily("宋体");
        const string strformat = "{0,-30},{1,-15},{2,-15},{3,-15}";
        StackPanel stackOutput;
        DateTime dtLast;
        [STAThread]
        public static void Main()
        {
            ExamineRoutedEvents app = new ExamineRoutedEvents();
            app.Run();
        }
        protected override void OnStartup(StartupEventArgs e)
        {
            base.OnStartup(e);
            Window win = new Window();
            win.Title = "Examine Routed Events";
            //建立Grid
            Grid grid = new Grid();
            win.Content = grid;
            //建立三行
            RowDefinition rowdef = new RowDefinition();
            rowdef.Height = GridLength.Auto;
            grid.RowDefinitions.Add(rowdef);

            rowdef = new RowDefinition();
            rowdef.Height = GridLength.Auto;
            grid.RowDefinitions.Add(rowdef);

            rowdef = new RowDefinition();
            rowdef.Height = new GridLength(100, GridUnitType.Star);
            grid.RowDefinitions.Add(rowdef);

            //建立button,加入到grid
            Button btn = new Button();
            btn.HorizontalAlignment = HorizontalAlignment.Center;
            btn.Padding = new Thickness(24);
            btn.Margin = new Thickness(24);
            grid.Children.Add(btn);
            //建立textblock，加入button
            TextBlock text = new TextBlock();
            text.FontSize = 24;
            text.Text = win.Title;
            btn.Content = text;
            //建立标题，显示在ScrollViewer
            TextBlock textHeadings = new TextBlock();
            textHeadings.FontFamily = fontfam;
            textHeadings.Inlines.Add(new Underline(new Run(string.Format(strformat,
                "Routed Events", "Sender", "Source", "OriginalSource"))));
            grid.Children.Add(textHeadings);
            Grid.SetRow(textHeadings, 1);
            //加入Scorllviewer
            ScrollViewer scroll = new ScrollViewer();
            grid.Children.Add(scroll);
            Grid.SetRow(scroll, 2);
            //建立Stackpanel，放入Scorllviewer
            stackOutput = new StackPanel();
            scroll.Content = stackOutput;
            //新增事件处理器
            UIElement[] els = { win, grid, btn, text };
            foreach (UIElement el in els)
            {
                // Keyboard
                el.PreviewKeyDown += AllPurposeEventHandler;
                el.PreviewKeyUp += AllPurposeEventHandler;
                el.PreviewTextInput += AllPurposeEventHandler;
                el.KeyDown += AllPurposeEventHandler;
                el.KeyUp += AllPurposeEventHandler;
                el.TextInput += AllPurposeEventHandler;

                // Mouse
                el.MouseDown += AllPurposeEventHandler;
                el.MouseUp += AllPurposeEventHandler;
                el.PreviewMouseDown += AllPurposeEventHandler;
                el.PreviewMouseUp += AllPurposeEventHandler;
                
                // Stylus
                el.StylusDown += AllPurposeEventHandler;
                el.StylusUp += AllPurposeEventHandler;
                el.PreviewStylusDown += AllPurposeEventHandler;
                el.PreviewStylusUp += AllPurposeEventHandler;
                //Window,Grid,Textblock类没有click事件，所以用在ButtonBase类中定义的AddHandler方法
                el.AddHandler(Button.ClickEvent,
                    new RoutedEventHandler(AllPurposeEventHandler));               
            }
            win.Show();
        }

        void AllPurposeEventHandler(object sender, RoutedEventArgs e)
        {
            //如果有时间空隙，加入空格
            DateTime dtNow = DateTime.Now;
            if (dtNow - dtLast > TimeSpan.FromMilliseconds(100))
                stackOutput.Children.Add(new TextBlock(new Run()));
            dtLast = dtNow;
            //显示事件信息
            TextBlock text = new TextBlock();
            text.FontFamily = fontfam;
            text.Text = string.Format(strformat, e.RoutedEvent.Name,
                TypeWithoutNamespace(sender), 
                TypeWithoutNamespace(e.Source),
                TypeWithoutNamespace(e.OriginalSource));
            stackOutput.Children.Add(text);
            (stackOutput.Parent as ScrollViewer).ScrollToBottom();
        }
        string TypeWithoutNamespace(object obj)
        {
            string[] str = obj.GetType().ToString().Split('.');
            return str[str.Length-1];
        }
    }
}

　2.自定义路由事件 

    （1）声明并注册路由事件

    （2）为路由事件添加CLR事件包装

    （3）创建可以激发路由事件的方法

    以ButtonBase类中定义的Click路由事件为例：

public abstract class ButtonBase : ContentControl, ICommandSource
{
    //字段 声明路由事件
    public static readonly RoutedEvent ClickEvent;
    //构造函数 在静态构造函数中注册路由事件，也可在直接申明字段同时注册路由事件
    static ButtonBase()
    {
	//第1个参数为事件名
	//第2个参数为路由策略，有三种策略：Bubble（冒泡式），Tunnel（隧道式），Direct（直达式）
	//第3个参数为用于指定事件处理器的类型,该类型必须为委托类型，并且不能为 null
	//第4个参数为路由事件所在的类名
        ClickEvent = EventManager.RegisterRoutedEvent("Click", RoutingStrategy.Bubble, typeof(RoutedEventHandler), typeof(ButtonBase));
    }
    //事件 将路由事件包装成CLR事件
    public event RoutedEventHandler Click
    {
        add { base.AddHandler(ClickEvent, value); }
        remove { base.RemoveHandler(ClickEvent, value); }
    }
    //方法 创建激发事件的方法
    protected virtual void OnClick()
    {
        RoutedEventArgs e = new RoutedEventArgs(ClickEvent, this);
        base.RaiseEvent(e);
    }
}

　　进一步可参考：http://www.cnblogs.com/wilderhorse/articles/3231454.html

     在进行上述自定义路由事件后，就可以像CLR事件一样，订阅事件和处理事件了。其中，订阅本身的事件同CLR事件一样，订阅子节点的事件用AddHandler方法，如上面“使用路由事件”中的例子。