WPF-12 路由事件之二

Posted 2022-11-26 dotNET跨平台

WPF 为我们提供了许多不同的事件处理机制——它们是冒泡、隧道和直接的。这些都称为路由事件

直接事件

直接在事件源上处理，这个有点像WinForms中的按钮OnClick事件，直接在事件处理程序中处理业务

冒泡事件

当事件没有被元素（比如一个文本框）处理并且事件“冒泡”到持有它的 UI 容器时，就会发生冒泡

例如，假设你有一个包含StackPanel的窗口，在该面板内你有一个Grid，在该Grid内您有一个文本框。如果文本框未处理事件，则它会冒泡到Grid级别，如果未在该级别处理，则事件会进一步冒泡（称为可视化树）到可能会或可能不会被处理的面板。这个过程一直持续到它被处理或事件脱离了最顶层的元素

隧道事件

隧道与冒泡相反，事件不是沿着可视树向上传播，而是沿着可视树向下传播到源元素。隧道事件都以Preview开头，例如 PreviewDownKey和PreviewMouseButtonDown。可以在它们到达目标元素的途中捕获它们并进行处理

事件对

大多数冒泡事件都与隧道事件配对。例如，PreviewKeyDown（隧道）键事件与Keydown 事件（冒泡）配对。当隧道事件沿着视觉树向下工作并命中它起源的元素（比如一个按钮）时，如果它没有处理，那么该按钮将启动一个“Keydown”冒泡事件，该事件会在视觉树上冒泡直到它自己被处理

处理事件

每种类型的事件处理程序都传递一个RoutedEventArgs对象。该对象有三个常用属性，Handled属性和Source属性以及OriginalSource属性。将Handled设置为 true，并且任何沿可视化树的事件处理程序将不再处理该事件

前面我们的示例描述了一个指向文本框的隧道KeyDown事件。如果包含UI元素（窗口、面板或表格）捕获并处理隧道事件（通过将 Handled 属性设置为 true），则文本框将不会接收该事件，并且不会触发任何匹配的冒泡事件

<Window x:Class="Example_11.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
        xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
        xmlns:local="clr-namespace:Example_11"
        mc:Ignorable="d" Title="MainWindow" Height="450" Width="800" 
        Keyboard.PreviewKeyDown="Window_PreviewKeyDown"
        Keyboard.KeyDown="Window_KeyDown">
    <StackPanel Height="300" Width="400" 
                Keyboard.PreviewKeyDown="StackPanel_PreviewKeyDown"
                Keyboard.KeyDown="StackPanel_KeyDown">
        <Grid Height="250" Width="300"
              Keyboard.PreviewKeyDown="Grid_PreviewKeyDown"
              Keyboard.KeyDown="Grid_KeyDown">
            <Grid.RowDefinitions>
                <RowDefinition></RowDefinition>
                <RowDefinition></RowDefinition>
            </Grid.RowDefinitions>
            <TextBox Grid.Row="0" Width="200" Height="30"></TextBox>
            <Button Grid.Row="1" Width="200" Height="50">Button</Button>
        </Grid>
    </StackPanel>
</Window>

using System.Windows;
using System.Windows.Input;
namespace Example_11

    /// <summary>
    /// Interaction logic for MainWindow.xaml
    /// </summary>
    public partial class MainWindow : Window
    
        public MainWindow()
        
            InitializeComponent();
        
        private void Window_PreviewKeyDown(object sender, KeyEventArgs e)
        
            MessageBox.Show("Window_PreviewKeyDown");
            //e.Handled = true;
        
        private void StackPanel_PreviewKeyDown(object sender, KeyEventArgs e)
        
            MessageBox.Show("StackPanel_PreviewKeyDown");
            //e.Handled = true;
        
        private void Grid_PreviewKeyDown(object sender, KeyEventArgs e)
        
            MessageBox.Show("Grid_PreviewKeyDown");
            //e.Handled = true;
        
        private void Grid_KeyDown(object sender, KeyEventArgs e)
        
            MessageBox.Show("Grid_KeyDown");
            //e.Handled = true;
        
        private void Window_KeyDown(object sender, KeyEventArgs e)
        


            MessageBox.Show("Window_KeyDown");
            //e.Handled = true;
        
        private void StackPanel_KeyDown(object sender, KeyEventArgs e)
        
            MessageBox.Show("StackPanel_KeyDown");
            //e.Handled = true;
        
    

当我们向TextBox输入值时，会看到事件的执行顺序为:

1. Window_PreviewKeyDown

2. StackPanel_PreviewKeyDown

3. Grid_PreviewKeyDown

4. Grid_KeyDown

5. StackPanel_KeyDown 

6. Window_KeyDown

   在本文中，我们看到 WPF 中的用户界面事件可以是隧道、冒泡或直接事件。针对隧道和冒泡事件，我们可以捕捉、处理事件或让事件继续执行。我们可以通过捕获隧道事件并将 Handled 属性设置为 true 来阻止息到达控件