WPF新手村教程（三）—— 路由事件

WPF个人文档（三）------ 路由事件

---

一.路由事件

先来说一下分类，参考某位博主以及博主参考的对应资料分类，先留个印象，然后我们逐步讲解

• 路由事件：冒泡事件、隧道事件（预览事件）、直接事件（直达事件）

• 事件（从作用角度划分）：生命周期事件、输入事件（鼠标事件、键盘输入事件、触控事件）

  ---

1.路由 ------ 在既定结构中，按照规则传播信号的路径

路径 → 静态结构
规则 → 传播策略
信号 → 事件

• 路由 ：网络工程术语，指分组从源到目的地时，决定端到端路径的网络范围的进程

  • 路由的本质：信息从哪里来，要往哪里去，经过哪些节点

  • 1.最原始的路由：网络

    • 在互联网里，一个数据包从电脑中发出去，不是直线飞到服务器
    • 它要经过多个路由器，每个路由器根据规则决定"下一跳"
    • 不是简单传递，而是"根据结构和规则决定传播路径"

  • 2.抽象到程序中

    • 当一个事件发生时，它不一定只通知一个对象，它可能沿着某种结构传播

    • 而这整条"传播路径"就是我们所说的路由

      # 比如 UI 是一棵树
      Window
       └── Grid
        └── Button

      • 当 Button 被点击时，事件可以：

        • 只在 Button 内处理（直达）
        • 往上通知 Grid → Window（冒泡）
        • 或者从 Window 先往下检查（隧道）

---

2.路由事件

前面我们已经提到过路由事件的分类，现在我们对其进行较为详细的 吐槽 讲解

• 路由事件：冒泡事件、隧道事件（预览事件）、直接事件（直达事件）

  ---

• 1.🌱冒泡事件 → 由里往外

  • 传播方向：子 → 父

    • 典型例子：MouseDown、KeyDown、Click

  • 使用场景：子控件触发行为，但由父容器统一处理

    • 统一日志
    • 权限判断
    • 容器级行为控制
    • MVVM 中命令转发

  • 代码示例：

    // 只要窗口里任何 Button 被点击，Window 都能收到
    this.AddHandler(Button.ClickEvent, new RoutedEventHandler(Window_Click));

  • 优点：解耦

  • 缺点：调试时要小心，可能在半路被 e.Handled = true 截断

    ---

• 2.🌱隧道事件 → 从外往里

  • 传播方向：父 → 子

    • 事件先从 Window 往下走到最底层控件，然后才进入冒泡阶段
    • 即：父级可以"预先审查"事件

  • 典型事件格式：PreviewXXX

    • 比如：PreviewMouseDown、PreviewKeyDown

  • 经典场景：全局快捷键、输入过滤、行为拦截

  • 代码示例：

    // 行为拦截：子控件接收不到按键 F5
    private void Window_PreviewKeyDown(object sender, KeyEventArgs e)
    {
        if (e.Key == Key.F5)
            e.Handled = true;
        // e.Handled = true 表示这个按键的路由到此结束
        	// 这个事件已经被处理完了，不需要继续传播
        	// 1.阻止事件继续沿当前路由传播
        	// 2.阻止对应的后续阶段执行
    }

    ---

• 3.🌱直达事件 → 不传播

  • 传播方向：只在当前控件触发，不向上也不向下

  • 典型例子：MouseEnter、MouseLeave、Loaded

  • !IMPORTANT

    • 为什么它只在当前控件触发，不向上不向下?
      • 因为语义上不适合传播
      • 鼠标进入 Button，不等于进入它父 Grid
      • 如果冒泡，会产生逻辑污染

  • 直达事件适合：

    • 局部状态改变
    • 单控件行为
    • 不需要结构参与的逻辑

  ---

  • 总结
    • 🌱冒泡事件：我干了件事，要向上级汇报。
    • 🌱隧道事件：我要干件事，谁敢不同意的？
    • 🌱直达事件：我自己的事，谁也管不了我！

  类型	传播方向	典型事件	核心作用	适用场景	优点	风险点
  🌱冒泡事件	子 → 父	MouseDown KeyDown Click	子控件触发，上层统一处理	1.统一日志 2.权限判断 3,命令转发 4.容器控制	解耦、集中管理	可能被 e.Handled 中途截断，调试链路复杂
  🌱隧道事件	父 → 子	PreviewMouseDown PreviewKeyDown	事件发生前的"预审查"机制	1.全局快捷键 2.输入过滤 3.行为拦截	可提前控制	滥用会造成隐藏拦截逻辑
  🌱直达事件	不传播	MouseEnter MouseLeave Loaded	仅当前控件自身处理	1.局部状态变化 2.生命周期控制	语义清晰	不能参与结构级控制

---

二.普通事件

回顾之前的分类

• 事件（从作用角度划分）：生命周期事件、输入事件（鼠标事件、键盘输入事件、触控事件）

  • 换句话说，是根据 事件在干什么 分类的

  ---

1.生命周期事件 → 控件自己的阶段变化

要理解生命周期事件，需要考虑一件事情：这个控件现在处于什么阶段？ ，它描述的是"状态变化"

• 常见生命周期事件：Initialized、Loaded、Unloaded、SizeChanged

• 代码示例：通常为直达事件

  // 控件初始化
  public MyControl()
  {
      InitializeComponent();
      this.Initialized += (s, e) =>
      {
          Debug.WriteLine("控件初始化完成");
      };
  }
  
  // 控件在视觉树中的加载
  private void UserControl_Loaded(object sender, RoutedEventArgs e)
  {
      // 这里可以安全访问 ActualWidth
      Debug.WriteLine(this.ActualWidth);
  }
  
  // 控件离开视觉树
  private void UserControl_Unloaded(object sender, RoutedEventArgs e)
  {
      // 释放资源
      timer.Stop();
  }
  
  // 布局尺寸发生变化
  private void Grid_SizeChanged(object sender, SizeChangedEventArgs e)
  {
      Debug.WriteLine($"新尺寸: {e.NewSize}");
  }

---

2.输入事件 → 用户或外部行为驱动

要理解输入事件，需要考虑一件事情：用户做了什么？ ，来源是操作系统输入系统 ，本质是用户行为推动系统状态变化

• 常见输入事件：MouseDown / MouseMove、KeyDown / KeyUp

• 代码示例:

  // 键盘输入
  private void Window_KeyDown(object sender, KeyEventArgs e)
  {
      if (e.Key == Key.Enter)
      {
          Submit();
      }
  }
  
  // 隧道路由 -> 数据拦截
  private void Window_PreviewKeyDown(object sender, KeyEventArgs e)
  {
      if (e.Key == Key.F5)
      {
          e.Handled = true; // 阻断传播
      }
  }
  
  // 鼠标输入
  private void Button_MouseDown(object sender, MouseButtonEventArgs e)
  {
      Debug.WriteLine("鼠标按下");
  }

---

维度	生命周期事件	输入事件
核心问题	控件现在处于什么阶段？	用户做了什么？
时间属性	内部时间	外部时间
触发来源	控件状态变化	操作系统输入
是否依赖用户	否	是
典型事件	Loaded / Unloaded / SizeChanged	MouseDown / KeyDown / TextInput
路由类型	多为 Direct	多为 Bubble + Tunnel
常见用途	初始化、释放、布局响应	行为驱动、交互控制
滥用风险	状态逻辑与业务耦合	传播链复杂、拦截难追踪

---

三.路由事件 VS 普通事件

• 普通事件 是 对象之间的通信

  • 普通事件 强调 对象之间的关系

  • 点对点：A → B

• 路由事件 是 结构中的信号传播

  • 路由事件 强调 层级结构的控制权

  • A → 父 → 祖父 → ...
    或者
    祖父 → 父 → A

    路径由"结构"决定，而不是写代码时手动指定

维度	普通事件	路由事件
传播方式	点对点	沿视觉树传播
是否有传播路径	没有	有（冒泡 / 隧道 / 直达）
是否可拦截	不支持	支持 e.Handled
结构参与决策	不参与	由 UI 树结构决定
典型场景	业务逻辑通知	输入系统、控件行为管理
复杂度	简单	较复杂

---

四.UI与树状结构 ------ 以 "空间和归属" 思考UI结构

在路由事件中，我们可以将UI 的可视元素（Window、Grid、Button、TextBox......）看作一棵树（树状结构）

Window
├─ Grid
│  ├─ Button
│  └─ TextBox
└─ StatusBar

• 这棵树告诉我们：

  • 父级和子级的关系

  • 控件层级和布局关系

  • 事件传播路径（冒泡/隧道）

• 树结构决定了结构相关的行为：

  • 路由事件传播

  • 父控件统一拦截子控件行为

  • 布局和绘制顺序

• !NOTE

  • 如何在Visual Studio中查看WPF中UI的树状结构？
    • 只需要打开文档大纲即可，文档大纲在项目中默认显示在左侧
    • 如果不小心关闭，使用快捷键 Ctrl+Alt+T 来快速打开文档大纲视图

  

  

---

随笔参考：25.第5章_路由概念及路由事件_哔哩哔哩_bilibili