WPF编程宝典 - 05路由事件

路由事件

  路由事件时具有更强传播能力的事件——它们可在元素树中向上冒泡和向下隧道传播，并且沿着传播路径被事件处理程序处理。路由事件允许事件在某个元素上被处理（如标签），即使该事件源自另一个元素（如标签内部的一幅图像）也是如此。与依赖项属性一样，可通过传统的方式使用路由事件——通过关联具有正确签名的事件处理程序——但为了使用路由事件的所有功能，需要理解其工作原理。

理解路由事件

  每个.NET开发人员都熟悉“事件”的思想–当有意义的事情发生时,由对象(如WPF元素)发送的用于通知代码的消息。WPF通过事件路由(event routing)的概念增强了.NET事件模型。事件路由允许源自某个元素的事件由另一个元素引发。例如,使用事件路由,来自工具栏按钮的单击事件可在被代码处理之前上传到工具栏,然后上传到包含工具栏的窗口。

定义/注册和封装路由事件

  WPF事件模型和WPF属性模型非常类似。与依赖项属性一样,路由事件由只读的静态字段表示,在静态构造函数中注册,并通过标准的.NET事件定义进行封装。

例如,WPF 的Button类提供了大家熟悉的Click事件,该事件继承自抽象的ButtonBase基类。下面的代码说明了该事件是如何被定义和注册的:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29

public abstract class ButtonBase : ContentControl 
{
    // 定义路由事件
    public static readonly RoutedEvent ClickEvent;

    // 注册路由事件
    static ButtonBase()
    {
        ButtonBase.ClickEvent = EventManager.RegisterRoutedEvent(
            "Click", // 事件名称
            RoutingStrategy.Bubble, // 路由类型
            typeof(RoutedEventHandler), // 事件处理程序语法的委托
            typeof(ButtonBase) // 拥有事件的类
        )
    }

    // 封装路由事件
    public event RoutedEventHandler Click
    {
        add
        {
            base.AddHandler(ButtonBase.ClickEvent,value);
        }
        remove
        {
            base.RemoveHandler(ButtonBase.ClickEvent,value);
        }
    }
}

共享路由事件

  与依赖项属性一样，可在类之间共享路由事件的定义。例如，UIElement(该类是所有普通WPF 元素的起点)和ContentElement(该类是所有内容元素的起点，内容元素是可以被放入流文档中的单独内容片段)这两个基类都使用了MouseUp事件。MouseUp事件是由SvstemWindows.Input,.Mouse类定义的。UElement 类和 ContentElement类只通过Routed- Event.AddOwner()方法重用MouseUp事件:

1

UIElement.MouseUpEvent = Mouse.MouseUpEvent.AddOwner(typeof(UIElement));

引发路由事件

  路由事件不是通过传统的.NET事件封装器引发的，而是使用RaiseEvent()方法引发事件，所有元素都从UIElement类继承了该方法。

1
2

RoutedEventArgs e = new RoutedEventArgs(ButtonBase.ClickEvent,this);
base.RaiseEvent(e); // RaiseEvent()方法负责为每个已经通过 AddHandler()方法注册的调用程序引发事件。

  所有WPF事件都为事件签名使用熟悉的.NET约定。每个事件处理程序的第一个参数（sender参数）都提供引发事件的对象的引用。第二个参数时EventArgs对象，该独显与其他所有可能很重要的附加细节绑定在一起。例如，MouseUp事件提供了一个MouseEventArgs对象，用于指示但事件发生时按下了哪些鼠标键：

1
2
3
4

private void img_MouseUp(object sender,MouseButtonEventArgs e)
{

}

处理路由事件

XAML标记

  最常用的方法是为XAML标记天机事件特性。通常约定“元素名_事件名”的形式明明事件处理程序方法。

1

<Image x:Name="img" Source="happyface.jpg" Stretch="None" MouseUp="img_MouseUp"/>

代码连接

  如果需要动态创建控件,并在窗口生命周期的某一时刻关联事件处理程序,代码方法是非常有用的。

1
2

img.MouseUp += new MouseButtonEventHandler(img_Mouseup); // 完整写法
img.MouseUp += img_MouseUp; // 简写

事件封装器

  当使用这种方法时，始终需要创建合适的委托类型，而不是能隐式地创建委托对象。这是因为UIElement.AddHandler()方法支持所有WPF事件，并且他不知道您要使用的委托类型

1

img.AddHandler(UIElement.MouseUpEvent,new MouseButtonEventHandler(img_MouseUp));

断开事件处理程序

1
2
3

img.MouseUp -= img_MouseUp;
// or
img.RemoveHandler(Imgae.MouseUpEvent,new MouseButtonEventHandler(img_MouseUp));

事件路由

  WPF中的许多空间都是内容控件，而内容控件可包含任何类型以及大量的嵌套内容，因此恰当的事件标记处理可以避免处理程序变得杂乱无章。

路由手机将实际上以下列三种方式出现：

• 直接路由事件（direct event）：与普通.NET事件类似，它们源于一个元素，不传递给其他元素，例如，MouseEnter事件（当鼠标指针移到元素上时发生）
• 冒泡路由事件（bubbling event）：在包含层次中向上传递的，通常鼠标事件都是冒泡路由事件，例如，MouseDown事件，该事件首先由被单击的元素引发，接下来被该元素的父元素引发，然后被父元素的父元素引发，以此类推，直到WPF到达元素树顶部为止
• 隧道路由事件（tunneling event）：在包含层次中向下传递，通常以Preview开头的事件，隧道路由事件在事件到达恰当的控件之前为预览事件（甚至终止事件）提供了机会，例如，通过PreviewKeyDown事件可截获时候按下了某个键。首先在窗口级别上，然后时更具体的容器，直到到达但按下键时具有焦点的元素。

RoutedEventArgs类

  在处理冒泡路由事件时，sender参数提供了对整个链条上最后那个链接的引用

处理挂起的事件

  AddHandler()方法提供了一个重载版本,该版本可以接收一个Boolean值作为它的第三个参数。如果将该参数设置为true,那么即使设置了Handled标志,也将接收到事件:

1

cmdClear.AddHandler(UIElement.MouseUpEvent,new MouseButtonEventHandler(cmdClear_MouseUp),true);

附加事件

  假设在StackPanel面板中封装了一堆按钮，并希望在一个事件处理程序中处理所有这些按钮的单击事件。。粗略的方法是将每个按钮的Click事件关联到同一个事件处理程序。但Click事件支持事件冒泡,从而提供了一种更好的选择。可通过处理更高层次元素的Click事件(如包含按钮的StackPanel面板)来处理所有按钮的Click事件。

1
2
3
4
5
6
7

<StackPanel Button.Click = "DoSomething">
    <Button Name="cmd1" Content="Button"/>
    <Button Name="cmd2" Content="Button"/>
    <Button Name="cmd3" Content="Button"/>
    <Button Name="cmd4" Content="Button"/>
    <Button Name="cmd5" Content="Button"/>
</StackPanel>

1
2
3
4
5
6
7
8

private void DoSomething(object sender, RoutedEventArgs e)
{
    if(sender == cmd1)
    {}
    else if(sender == cmd2)
    {}
    ....
}

隧道路由事件

  隧道路由事件的工作方式和冒泡路由事件相同，但方向相反。隧道路由事件易于识别，它们都以单词 Preview开头。而且，WPF通常成对地定义冒泡路由事件和隧道路由事件。这意味着如果发现冒泡的MouseUp事件，就还可以找到PreviewMouseUp 隧道事件。隧道路由事件总在冒泡路由事件之前被触发

WPF事件

  尽管每个元素都提供了许多事件，但最重要的事件童话参观包括以下5类：

• 生命周期事件：在元素被初始化、加载或卸载时发生这些事件
• 鼠标事件：这些事件时鼠标动作的结果
• 键盘事件：这些事件时键盘动作（如按下键盘上的键）的结果
• 手写笔事件：这些事件时使用类似钢笔的手写笔的结果，在平板电脑上用手写笔代替鼠标
• 多点触控事件：这些事件时一根或多根手指在多点触控屏幕上触摸的结果。仅在Widdows7中支持这些事件

生命周期事件

  但首次创建以及释放所有元素时都会引发事件，可使用这些事件初始化窗口。

  为了弄清Initialized 事件和Loaded 事件之间的关系，分析一下呈现过程是有帮助的。FrameworkElement 类实现了 ISupportInitialize 接口，该接口提供了两个用于控制初始化过程的方法。

1. 第一个方法是 BeginInit()，在实例化元素后会立即调用该方法。调用 BeginInit( )方法后,XAML 解析器设置所有元素的属性(并添加内容)。
2. 第二个方法是Endnit()，完成初始化后，将调用该方法，此时引发Initialized 事件。

输入事件

  输入事件是当用户使用某些种类的外设硬件进行交互时发生的事件，例如鼠标、键盘、手写笔或多点触控屏。输入事件可通过继承自InputEventArgs 的自定义事件参数类传递额外的信息。下图显示了继承层次。

  InputEventArgs 类只增加了两个属性:Timestamp和 Device。Timestamp 属性提供了一个整数，指示事件何时发生的毫秒数(它所代表的实际时间并不重要，但可比较不同的时间戳值以确定哪个事件先发生。时间戳值大的事件是在更近发生的)。Device 属性返回一个对象，该对象提供与触发事件的设备相关的更多信息，设备可以是鼠标、键盘或手写笔。这三种可能的设备由不同的类表示，所有这些类都继承自抽象类System.Windows.Input.InputDevice。

键盘输入

  当用户按下键盘上的一个键时，就会发生一系列事件。下面根据它们发生的顺序列出了这些事件。

  键盘处理永远不会像上面看到的这么简单。一些控件可能会挂起这些事件中的某些事件，从而可执行自己更特殊的键盘处理。最明显的例子是 TextBox 控件，它挂起了TextInput 事件。对于一些按键，TextBox 控件还挂起了KeyDown 事件，如方向键。对于此类情形，通常仍可使用隧道路由事件(PreviewTextInput和PreviewKeyDown 事件)。
  TextBox 控件还添加了名为 TextChanged 的新事件。在按键导致文本框中的文本发生改变之后会立即引发该事件。这时，在文本框中已经可以看到新的文本，所以阻止不需要的按键已为时太晚。

获取键盘状态

鼠标输入

  鼠标事件执行几个关联的任务。当鼠标移到某个元素上时，可通过最基本的鼠标事件进行响应。这些事件是 MouseEnter(当鼠标指针移到元素上时引发该事件)和 MoseLeave(当鼠标指针离开元素时引发该事件)。这两个事件都是直接事件，这意味着它们不使用冒泡和隧道过程，而是源自一个元素并且只被该元素引发。考虑到控件嵌入到 WPF窗口的方式，这是合理的。

鼠标单击

  鼠标单击事件的引发方式和按键事件的引发方式有类似之处。区别是对于鼠标左键和鼠标右键引发不同的事件

捕获鼠标

  通常，元素每次接收到鼠标键“按下”事件后，不久后就会接收到对应的鼠标键“释放”事件。但情况不见得总是如此。例如，如果单击一个元素，保持按下鼠标键，然后移动鼠标指针离开该元素，这时该元素就不会接收到鼠标键释放事件。
  某些情况下，可能希望通知鼠标键释放事件，即使鼠标键释放事件是在鼠标已经离开了原来的元素之后发生的。为此，需要调用Mouse.Capture()方法并传递恰当的元素以捕获鼠标。此后就会接收到鼠标键按下事件和释放事件，直到再次调用Mouse.Capture()方法并传递空引用为止。当鼠标被一个元素捕获后，其他元素就不会接收到鼠标事件。这意味着用户不能单击窗口中其他位置的按钮，不能单击文本框的内部。鼠标捕获有时用于可以被拖放并可以改变尺寸的元素。

  有些情况下，可能由于其他原因(不是您的错)丢失鼠标捕获。例如，如果需要显示系统对话框，Windows 可能会释放鼠标捕获。如果当鼠标键释放事件发生后没有释放鼠标，并且用户单击了另一个应用程序中的窗口，也可能丢失鼠标捕获。无论哪种情况，都可以通过处理元素的 LostMouseCapture 事件来响应鼠标捕获的丢失。
  当鼠标被一个元素捕获时，就不能与其他元素进行交互(例如，不能单击窗口中的其他元鼠标捕获通常用于短时间的操作，如拖放。素)。

鼠标拖放

  本质上，拖放操作通过以下三个步骤进行：

1. 用户点击元素（或选择元素中的一块特定区域），并保持鼠标键为按下状态。这是，某些信息被搁置起来，并且拖放操作开始
2. 用户键鼠标移到其他元素上。如果该元素可接受正在拖动的内容的类型，鼠标指针会变成拖放图标，否则鼠标指针会变成内部有一条线的圆形
3. 当用户释放鼠标键时，元素接受信息并决定如何处理接收到的信息。在没有释放鼠标键时，可按下Esc键取消该操作

多点触控输入

  多点触控(multi-touch)是通过触摸屏幕与应用程序进行交互的一种方式。多点触控输入和更传统的基于笔(pen-based)的输入的区别是多点触控识别手势(gesture)—用户可移动多根手指以执行常见操作的特殊方式。

多点触控的输入层级

  WPF提供了三个独立的层次：

• 原始触控（raw touch）：这是最低级的支持，可访问用户执行的每个触控。缺点是由您的应用程序负责将单独的触控消息组合到一起，并对它们进行解释。如果不准备识别标准触摸手势，反而希望创建以独特方式响应多点触控输入的应用程序，使用原始触控是合理的。一个例子是绘图程序，例如 Windows7画图程序，该程序允许用户同时使用多根手指在触摸屏上绘图。
• 操作（manipulation）：操作(manipulation):这是一个简便的抽象层，该层将原始的多点触控输入转换成更有意义的手势，与WPF控件将一系列MouseDown和MouseUp 事件解释为更高级的MouseDoubleClick事件很相似。WPF 支持的通用手势包括移动(pan)、缩放(zoom)、旋转(rotate)以及轻按(tap)。
• 内置的元素支持（built-in element support）：内置的元素支持(built-in element support):有些元素已对多点触控事件提供了内置支持，从而不需要再编写代码。例如，可滚动的控件支持触控移动，如 ListBox、ListView、DataGrid、TextBox 以及 ScrollViewer.

原始触控

  与基本的鼠标和键盘事件一样，触控事件被内置到低级的UIElement以及ContentElement类。

  所有这些事件都提供了一个 TouchEventArgs对象，该对象提供了两个重要成员。

1. 第一个是GetTouchPoint()方法，该方法返回触控事件发生位置的屏幕坐标(还有一些不怎么常用的数据例如触点的大小)。
2. 第二个是 TouchDevice 属性，该属性返回一个 TouchDevice 对象。这里的技巧是将每个触点都视为单独设备。因此，如果用户在不同的位置按下了两根手指(同时按下或者先按下一根再按下另一根)，WPF将它们作为两个触控设备，并为每个触控设备指定唯一的ID。当用户移动这些手指，并且触控事件发生时，代码可以通过 TouchDevice.Id 属性区分两个触点

操作

  WPF为手势提供了更高级别的支持，称为触控操作(manipulation)。通过将元素的 IsManipulationEnabled 属性设为 True，将元素配置为接受触控操作。然后可响应4个操作事件:ManipulationStarting、ManipulationStartedManipulationDelta 以及ManipulationCompleted.

惯性

  WPF 还有一层构建在基本操作支持之上的特性，称为惯性(intertia)。本质上，通过惯性可以更逼真、更流畅地操作元素。
  只需处理 ManipulationInertiaStarting 事件。当用户结束手势并抬起手指释放元素时，触发 ManipulationInertiaStarting 事件。这时，可使用 ManipulationInertiaStartingEventsArgs 对象确定当前速度–当操作结束时元素的移动速度–并设置希望的减速度。下面的示例为移动、缩放以及旋转手势添加了惯性:

  为使元素从障碍物自然地被弹回，需要在 ManipulationDelta 事件中检查是否将元素拖到了错误的位置。如果穿过了一条边界，那么由您负责通过调用ManipulationDeltaEventArgsReportBoundaryFeedback()方法进行报告。