深入理解 WPF 路由事件机制
WPF 的事件系统超越了传统桌面应用的单向触发模式，引入了事件路由（Event Routing）这一核心特性。它允许一个元素上发生的事件沿着元素树向上或向下传播，从而实现更灵活、高效的事件处理策略。
在底层实现中，路由事件通过静态只读字段定义，并在类的静态构造函数中注册。以按钮点击事件为例，其声明如下：
public abstract class ButtonBase : ContentControl
{
public static readonly RoutedEvent ClickEvent;
static ButtonBase()
{
ClickEvent = EventManager.RegisterRoutedEvent(
"Click",
RoutingStrategy.Bubble,
typeof(RoutedEventHandler),
typeof(ButtonBase)
);
}
public event RoutedEventHandler Click
{
add => AddHandler(ClickEvent, value);
remove => RemoveHandler(ClickEvent, value);
}
}
该设计确保了跨语言兼容性，所有 .NET 语言均可通过标准事件语法访问。实际处理由 AddHandler 与 RemoveHandler 方法完成，这些方法继承自 FrameworkElement。
在 XAML 中，可直接绑定事件处理器：
<Image Source="happy.jpg" Name="img" MouseUp="img_MouseUp" />
命名约定为"控件名_事件名"，也可省略控件名用于无交互场景。在 C# 中，支持简洁的委托写法：
img.MouseUp += img_MouseUp;
等价于显式调用：
img.AddHandler(Image.MouseUpEvent, new MouseButtonEventHandler(img_MouseUp));
推荐使用具体控件类名（如 Image.MouseUpEvent）而非通用基类（如 UIElement.MouseUpEvent），以避免歧义，尤其在嵌套结构中。
断开事件监听需使用：
img.MouseUp -= img_MouseUp;
// 或
img.RemoveHandler(Image.MouseUpEvent, new MouseButtonEventHandler(img_MouseUp));
重复添加同一处理程序虽技术可行，但会导致多次触发，属于典型错误行为。
为了统一响应子元素的操作，例如希望点击任意子控件时都执行相同逻辑，可利用事件路由机制。假设有一个包含多个文本块和图像的标签容器，若对每个子元素分别绑定事件将导致代码冗余。此时可通过冒泡路由实现集中处理。
事件路由有三种类型：
- 直接路由：事件仅在源元素触发，不传播。
- 冒泡路由（Bubbling）：事件从源元素开始，逐级向父元素传递，如
MouseDown。 - 隧道路由（Tunneling）：事件从根元素开始，向下传递至目标元素，通常以
Preview开头，如PreviewKeyDown。
注册事件时通过 RoutingStrategy 枚举指定行为。
当事件被标记为已处理（e.Handled = true）后，后续的路由过程将停止。可通过重载的 AddHandler 方法启用"挂起处理"模式：
cmdClear.AddHandler(UIElement.MouseUpEvent, new MouseButtonEventHandler(cmdClear_MouseUp), true);
附加事件（Attached Events）是另一项强大功能。例如，在 StackPanel 上捕获其内部所有 Button 的点击事件，尽管 StackPanel 本身没有 Click 事件。只需使用类名加点语法：
<StackPanel Button.Click="DoSomething">
<Button Name="cmd1">Command 1</Button>
<Button Name="cmd2">Command 2</Button>
<Button Name="cmd3">Command 3</Button>
</StackPanel>
此语法本质是将事件绑定到特定派生类。在代码中必须使用 AddHandler：
pnlButtons.AddHandler(Button.Click, new RoutedEventHandler(DoSomething));
要获取触发事件的具体元素，可通过 sender 参数判断，建议为每个按钮设置 Name 属性；更优做法是利用 Tag 属性携带上下文信息：
<Button Tag="First Action">Command 1</Button>
在事件处理中提取：
private void DoSomething(object sender, RoutedEventArgs e)
{
var element = (FrameworkElement)sender;
var tag = element.Tag as string;
MessageBox.Show(tag ?? "Unknown");
}
隧道事件与冒泡事件成对出现，且隧道事件优先触发。若隧道事件被标记为已处理，则冒泡链将被中断，因为两者共享同一个 RoutedEventArgs 实例。
