C#中的路由事件(Routed Events)

路由事件的基本概念

路由事件是WPF中特有的事件系统，它允许事件在可视化树中"路由"传递，具有以下特点：

1. 事件路由方向：

   • 冒泡(Tunneling)：从事件源向根元素传递

   • 隧道(Bubbling)：从根元素向事件源传递

   • 直接(Direct)：仅在事件源处理

2. 事件处理机制：

   • 允许多个元素处理同一事件

   • 可以在父元素中处理子元素的事件

路由事件的实现原理

核心组件

1. EventManager类：负责注册和管理路由事件

2. RoutedEvent类：表示路由事件本身

3. RoutedEventArgs类：包含路由事件数据

事件路由过程

1. 事件在源元素触发

2. 根据路由策略向上或向下传递

3. 每个元素都有机会处理事件

4. 可以通过e.Handled = true终止路由

代码示例

示例1：自定义路由事件

public class MyButton : Button
{
    // 1. 注册路由事件
    public static readonly RoutedEvent MyCustomEvent = 
        EventManager.RegisterRoutedEvent(
            "MyCustom",                     // 事件名称
            RoutingStrategy.Bubble,         // 路由策略
            typeof(RoutedEventHandler),     // 事件处理程序类型
            typeof(MyButton));             // 拥有者类型
    
    // 2. 提供CLR事件包装器
    public event RoutedEventHandler MyCustom
    {
        add { AddHandler(MyCustomEvent, value); }
        remove { RemoveHandler(MyCustomEvent, value); }
    }
    
    // 3. 触发事件的方法
    protected virtual void OnMyCustom()
    {
        RoutedEventArgs args = new RoutedEventArgs(MyCustomEvent);
        RaiseEvent(args);
    }
    
    protected override void OnClick()
    {
        base.OnClick();
        OnMyCustom(); // 点击时触发我们的自定义事件
    }
}

示例2：使用冒泡路由事件

<Window x:Class="WpfApp.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        Title="路由事件示例" Height="350" Width="525"
        ButtonBase.Click="Window_Click"> <!-- 在Window级别处理所有按钮点击 -->
    
    <StackPanel>
        <Button Content="按钮1" Margin="5" Padding="5"/>
        <Button Content="按钮2" Margin="5" Padding="5"/>
        <Button Content="按钮3" Margin="5" Padding="5" Click="Button3_Click"/>
    </StackPanel>
</Window>

// 代码后台
private void Window_Click(object sender, RoutedEventArgs e)
{
    Button btn = e.OriginalSource as Button;
    if (btn != null)
    {
        MessageBox.Show($"Window处理了按钮 {btn.Content} 的点击事件");
        // e.Handled = true; // 如果取消注释，Button3_Click将不会执行
    }
}

private void Button3_Click(object sender, RoutedEventArgs e)
{
    MessageBox.Show("Button3的专属点击处理");
    e.Handled = true; // 阻止事件继续冒泡
}

示例3：隧道路由事件应用

<Window x:Class="WpfApp.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        PreviewMouseDown="Window_PreviewMouseDown">
    
    <Grid MouseDown="Grid_MouseDown" PreviewMouseDown="Grid_PreviewMouseDown">
        <Button Content="点击我" 
                Width="100" Height="30"
                MouseDown="Button_MouseDown" 
                PreviewMouseDown="Button_PreviewMouseDown"/>
    </Grid>
</Window>

// 代码后台
private void Window_PreviewMouseDown(object sender, MouseButtonEventArgs e)
{
    Debug.WriteLine("Window PreviewMouseDown (隧道)");
}

private void Grid_PreviewMouseDown(object sender, MouseButtonEventArgs e)
{
    Debug.WriteLine("Grid PreviewMouseDown (隧道)");
}

private void Button_PreviewMouseDown(object sender, MouseButtonEventArgs e)
{
    Debug.WriteLine("Button PreviewMouseDown (隧道)");
}

private void Button_MouseDown(object sender, MouseButtonEventArgs e)
{
    Debug.WriteLine("Button MouseDown (冒泡)");
}

private void Grid_MouseDown(object sender, MouseButtonEventArgs e)
{
    Debug.WriteLine("Grid MouseDown (冒泡)");
}

输出顺序：

1. Window PreviewMouseDown (隧道)

2. Grid PreviewMouseDown (隧道)

3. Button PreviewMouseDown (隧道)

4. Button MouseDown (冒泡)

5. Grid MouseDown (冒泡)

实际应用场景

1. 全局事件处理：在父容器中统一处理子元素事件

2. 组合控件：自定义控件内部元素事件冒泡到控件级别

3. 事件拦截：在路由过程中拦截并处理事件

4. 输入事件处理：处理鼠标/键盘等输入事件的隧道和冒泡阶段

路由事件与CLR事件的区别

特性	路由事件	CLR事件
传播方式	可视化树中路由	直接绑定
处理者	多个元素可处理	单一处理者
事件参数	RoutedEventArgs	EventArgs
注册方式	EventManager.RegisterRoutedEvent	event关键字
典型应用	WPF控件交互	普通类事件处理

路由事件是WPF强大交互能力的基础，合理利用可以极大简化复杂UI的事件处理逻辑。