WPF—路由事件详解

WPF---路由事件

路由事件是一种可以针对元素树中的多个侦听器而不是仅仅针对引发该事件的对象调用处理程序的事件。路由事件是一个CLR事件。

路由事件与一般事件的区别在于:路由事件是一种用于元素树的事件,当路由事件触发后,它可以向上或向下遍历可视树和逻辑树,他用一种简单而持久的方式在每个元素上触发,而不需要任何定制的代码(如果用传统的方式实现一个操作,执行整个事件的调用则需要执行代码将事件串联起来)。

路由事件的路由策略:

所谓的路由策略就是指:路由事件实现遍历元素的方式。

路由事件一般使用以下三种路由策略:

(1) 冒泡:由事件源向上传递一直到根元素。

(2) 直接::直接路由事件与普通的.NET事件是非常相似的,他们都起源于一个元素,并且不能够传递给其它的元素。只有事件源才有机会响应事件。

(3) 隧道:从元素树的根部调用事件处理程序并依次向下深入直到事件源。一般情况下,WPF提供的输入事件都是以隧道/冒泡对实现的。隧道事件常常被称为Preview事件。

管道

从元素树的根部调用事件处理程序并依次向下深入直到事件源。

管道事件按照惯例,他们的名字中都有一个preview前缀,一般来说管道事件都有他的配对的冒泡事件,例如:PreviewMouseDown和MouseDown就是配对事件,如果同时存在的话,那么就会先执行管道事件然后才执行配对的冒泡事件。当然e.Handled=true,依然能够阻断事件。

当TextBlock的事件触发时,会从根元素进行传递直到TextBlock自身

cs 复制代码
    // XAML标签布局
        <Grid>
            <StackPanel Width="200"
                        Background="Gray"
                        Height="40"
                        PreviewMouseUp="StackPanel_MouseUp">
                <TextBlock Height="40" Background="blue" Width="40" Margin="-150,0,0,0"
                           PreviewMouseUp="TextBlock_MouseUp">
                </TextBlock>
            </StackPanel>
        </Grid>
    
    // 在CS后台文件写对应的数据
        private void TextBlock_MouseUp(object sender, MouseButtonEventArgs e)
        {
            Console.WriteLine("子控件textblock 鼠标松开");
        }
    
        private void StackPanel_MouseUp(object sender, MouseButtonEventArgs e)
        {
            Console.WriteLine("父控件StackPane 鼠标松开");
        }

结果:

冒泡

由事件源向上传递一直到根元素。

当触发TextBlock的事件时,会从自身一直向上传递直到根元素。

cs 复制代码
    // XAML标签布局
    <Grid>
        <StackPanel Width="200"
                    Background="Gray"
                    Height="40"
                    MouseUp="StackPanel_MouseUp">
            <TextBlock Height="40"
                       Background="blue"
                       Width="40"
                       Margin="-150,0,0,0"
                       MouseUp="TextBlock_MouseUp">
            </TextBlock>
        </StackPanel>
    </Grid>
    
    // 在CS后台文件写对应的数据
    private void TextBlock_MouseUp(object sender, MouseButtonEventArgs e)
    {
        Console.WriteLine("子控件textblock 鼠标松开");
    }
    
    private void StackPanel_MouseUp(object sender, MouseButtonEventArgs e)
    {
        Console.WriteLine("父控件StackPane 鼠标松开");
    }

结果:

直接

直接路由事件只传递一层。它源自一个元素,并且不传递给其他元素,MouseEnter事件(当鼠标指针移动到元素上时发生)是直接路由事件。

当鼠标移到TextBlock的时候会响应BlockMouseEnter事件,但是不会响应StackMouseEnter事件

cs 复制代码
    <StackPanel Orientation="Vertical" MouseEnter="StackMouseEnter" Background="Yellow">
      <TextBlock Text="Block鼠标移进来" Background="AliceBlue" Height="50" Width="100" MouseEnter="BlockMouseEnter" />
    </StackPanel>

如何阻断事件

e.Handled = true; 阻断事件

当Handled属性为true时阻断该事件的传递,后续事件不会再进行执行

cs 复制代码
    // XAML标签布局
        <Grid>
            <StackPanel Width="200"
                        Background="Gray"
                        Height="40"
                        PreviewMouseUp="StackPanel_MouseUp">
                <TextBlock Height="40" Background="blue" Width="40" Margin="-150,0,0,0"
                           PreviewMouseUp="TextBlock_MouseUp">
                </TextBlock>
            </StackPanel>
        </Grid>
    
    // 在CS后台文件写对应的数据
        private void TextBlock_MouseUp(object sender, MouseButtonEventArgs e)
        {
            Console.WriteLine("子控件textblock 鼠标松开");
        }
    
        private void StackPanel_MouseUp(object sender, MouseButtonEventArgs e)
        {
            Console.WriteLine("父控件StackPane 鼠标松开");
            e.Handled = true;// 阻断事件
        }

结果:

相关推荐
程序设计实验室13 小时前
C# 扩展方法只会写 this 吗?C# 14 新语法直接把扩展方法玩出了花
c#
唐青枫15 小时前
C#.NET SignalR 深入解析:实时通信、Hub 与连接管理实战
c#·.net
唐宋元明清218821 小时前
.NET Win32磁盘动态卷/跨区卷触发“函数不正确”问题排查
windows·c#·存储
hez20101 天前
Satori GC:同时做到高吞吐、低延时和低内存占用
c#·.net·.net core·gc·clr
唐青枫2 天前
C#.NET Channel 深入解析:高性能异步生产者消费者模型实战
c#·.net
小峥降临2 天前
Rokid UXR 的手势追踪虚拟中更真实的手实战开发【含 工程源码 和 最终完成APK】
c#
茶杯梦轩5 天前
从零起步学习RabbitMQ || 第三章:RabbitMQ的生产者、Broker、消费者如何保证消息不丢失(可靠性)详解
分布式·后端·面试
晨星shine6 天前
GC、Dispose、Unmanaged Resource 和 Managed Resource
后端·c#
回家路上绕了弯6 天前
深入解析Agent Subagent架构:原理、协同逻辑与实战落地指南
分布式·后端
用户298698530147 天前
.NET 文档自动化:Spire.Doc 设置奇偶页页眉/页脚的最佳实践
后端·c#·.net