WPF路由事件:冒泡、隧道与直接全解析

路由事件的三类传播方式

  • 冒泡事件(Bubbling)

    事件从源元素向上传递到根元素(如Button.Click)。

    XML 复制代码
    <StackPanel Button.Click="StackPanel_Click">
        <Button Content="Click Me"/>
    </StackPanel>
    csharp 复制代码
    private void StackPanel_Click(object sender, RoutedEventArgs e) {
        // 处理按钮点击事件
    }
  • 隧道事件(Tunneling)

    事件从根元素向下传递到源元素(命名以Preview开头,如PreviewMouseDown)。

    XML 复制代码
    <StackPanel PreviewMouseDown="StackPanel_PreviewMouseDown">
        <Button Content="Click Me"/>
    </StackPanel>
    csharp 复制代码
    private void StackPanel_PreviewMouseDown(object sender, MouseButtonEventArgs e) {
        // 在事件到达按钮前拦截
    }
  • 直接事件(Direct)

    仅触发在源元素上,不传播(如MouseEnter)。

  • 添加/移除事件处理器

    csharp 复制代码
    button.AddHandler(Button.ClickEvent, new RoutedEventHandler(HandleClick));
    button.RemoveHandler(Button.ClickEvent, new RoutedEventHandler(HandleClick));
  • 终止事件传播

    在事件处理器中设置e.Handled = true,阻止事件继续冒泡或隧道。

    csharp 复制代码
    private void HandleClick(object sender, RoutedEventArgs e) {
        e.Handled = true; // 停止传播
    }
  • 输入事件
    MouseDown(冒泡)、PreviewKeyDown(隧道)

  • 控件事件
    Button.Click(冒泡)、TextBox.TextChanged(直接)

  • 全局快捷键
    在窗口级处理PreviewKeyDown事件,拦截特定按键组合。

  • 控件组合交互
    父容器监听子控件的冒泡事件(如ListBox中按钮的点击)。

  • INotifyPropertyChanged实现:

    csharp 复制代码
    public class Model : INotifyPropertyChanged {
        private string _name;
        public string Name {
            get => _name;
            set { _name = value; OnPropertyChanged(nameof(Name)); }
        }
        public event PropertyChangedEventHandler PropertyChanged;
        protected void OnPropertyChanged(string propertyName) => 
            PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(propertyName));
    }

命令与MVVM

  • ICommand接口实现:

    csharp 复制代码
    public class RelayCommand : ICommand {
        private readonly Action _execute;
        public RelayCommand(Action execute) => _execute = execute;
        public bool CanExecute(object parameter) => true;
        public void Execute(object parameter) => _execute();
        public event EventHandler CanExecuteChanged;
    }
  • MVVM优势:解耦视图与逻辑,利于单元测试,支持设计时数据(d:DataContext)。

样式与模板

  • 控件模板示例:

    XML 复制代码
    <ControlTemplate TargetType="Button">
        <Border Background="{TemplateBinding Background}" CornerRadius="5">
            <ContentPresenter HorizontalAlignment="Center"/>
        </Border>
    </ControlTemplate>
  • 触发器类型:PropertyTriggerDataTriggerEventTrigger

性能优化

  • 虚拟化技术:VirtualizingStackPanel用于ListBox等控件,延迟加载可视项。

  • 依赖属性机制:静态注册节省内存,支持值继承、动画等。

    csharp 复制代码
    public static readonly DependencyProperty IsActiveProperty = 
        DependencyProperty.Register("IsActive", typeof(bool), typeof(MyControl));
    
    public bool IsActive {
        get => (bool)GetValue(IsActiveProperty);
        set => SetValue(IsActiveProperty, value);
    }

高级主题

  • 路由事件:Bubbling(冒泡)、Tunneling(隧道)、Direct(直接)。
  • 跨线程访问UI:Dispatcher.InvokeDispatcher.BeginInvoke
  • 自定义绘图:继承FrameworkElement,重写OnRender方法使用DrawingContext

调试技巧

  • 使用Snoop或WPF Inspector工具实时查看视觉树。
  • 绑定失败时查看Output窗口的绑定错误日志。
  • PresentationTraceSources.TraceLevel=High诊断绑定问题。
相关推荐
影寂ldy3 小时前
C# try-catch 异常处理全套笔记
服务器·数据库·c#
TeamDev4 小时前
JxBrowser 9.3.0 版本发布啦!
java·后端·c#·混合应用·jxbrowser·浏览器控件·异步媒体设备
梦帮科技5 小时前
UE5 GAS 实战:用 Gameplay Ability System 搭建「赛博修真」境界与技能体系
c++·人工智能·python·ue5·c#
北域码匠9 小时前
RIPEMD-128哈希算法深度解析
c#·密码学·哈希算法·加密算法·消息摘要·ripemd-128·原生实现
csdn_aspnet11 小时前
C# 截取或匹配字符串内包含指定字符
c#·字符串·正则·string·匹配·截取
hez20104 天前
在 .NET 上构建超大托管数组
c#·.net·.net core·gc·clr
雨落倾城夏未凉9 天前
第四章c#方法-参数数组和可选参数(16)
后端·c#
唐青枫11 天前
线程不是越多越快:C#.NET Thread 生命周期、同步与后台工作线程实战
c#·.net
唐青枫11 天前
别只会反射:C#.NET Emit 动态生成代码实战详解
c#·.net
咕白m62512 天前
.NET 环境下 Word 超链接批量提取方案
c#·.net