WPF-路由事件

逻辑树

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

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

事件路由

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

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

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

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

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

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

view sourceprint?

01	<Window x:Class="DeepXAML.MainWindow"

02	xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"

03	xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"

04	xmlns:local="clr-namespace:DeepXAML"

05	xmlns:sys="clr-namespace:System;assembly=mscorlib"

06	Title="MainWindow" Height="250" Width="450">

07	<Grid x:Name="rootGrid" Button.Click="rootGrid_Click">

08	<Button x:Name="btnOK" Margin="30">OK</Button>

09

</Grid>

10

</Window>

 

后台代码：

view sourceprint?

1	private void rootGrid_Click(object sender, RoutedEventArgs e)

2

{

3	MessageBox.Show((e.Source as FrameworkElement).Name); //btnOk

4	MessageBox.Show((e.OriginalSource as FrameworkElement).Name); //btnOk

5

}

 

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

 

自定义路由事件示例

view sourceprint?

01	<Window x:Class="DeepXAML.MainWindow"

02	xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"

03	xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"

04	xmlns:local="clr-namespace:DeepXAML"

05	xmlns:sys="clr-namespace:System;assembly=mscorlib"

06	Title="MainWindow" Height="250" Width="450">

07	<Grid x:Name="rootGrid" >

08	<StackPanel x:Name="stp1" local:TestButton.ClickTimeEvent="TimeHanler">

09	<StackPanel x:Name="stp2" local:TestButton.ClickTimeEvent="TimeHanler">

10	<StackPanel x:Name="stp3" local:TestButton.ClickTimeEvent="TimeHanler">

11	<ListBox x:Name="listBox"></ListBox>

12	<local:TestButton local:TestButton.ClickTimeEvent="TimeHanler" Height="50" Margin="30">OK</local:TestButton>

13	</StackPanel>

14	</StackPanel>

15	</StackPanel>

16

</Grid>

17

</Window>

view sourceprint?

1

后台代码

view sourceprint?

01	using System;

02	using System.Collections.Generic;

03	using System.Windows;

04	using System.Windows.Data;

05	using System.Windows.Documents;

06	using System.Windows.Controls;

07

08	namespace DeepXAML

09

{

10	public partial class MainWindow : Window

11

{

12	public MainWindow()

13

{

14	InitializeComponent();

15

16

}

17

18	private void TimeHanler(object sender, TimeEventArgs e)

19

{

20	FrameworkElement element = sender as FrameworkElement;

21	string strTime = e.ClickTime.ToLongTimeString();

22	this.listBox.Items.Add( element.Name+":"+ strTime);

23

}

24

}

25

26	public class TimeEventArgs : RoutedEventArgs

27

{

28	public TimeEventArgs(RoutedEvent routedEvent, object source):base(routedEvent,source)

29

{

30

}

31	public DateTime ClickTime { get; set; }

32

}

33

34	public class TestButton : Button

35

{

36	public static RoutedEvent timeEvent=

37	EventManager.RegisterRoutedEvent("ClickTimeEvent", RoutingStrategy.Bubble, typeof(EventHandler<TimeEventArgs>), typeof(TestButton));

38

39	public event  RoutedEventHandler ClickTimeEvent

40

{

41	add {this.AddHandler(timeEvent,value);}

42	remove{this.RemoveHandler(timeEvent,value);}

43

}

44

45	protected override void  OnClick()

46

{

47	base.OnClick();

48	TimeEventArgs args=new TimeEventArgs(timeEvent,this);

49	args.ClickTime=DateTime.UtcNow;

50	this.RaiseEvent(args);

51

}

52

}

53

}