WPF学习

一、隧道事件和冒泡事件

在WPF（Windows Presentation Foundation）中，PreviewKeyDown 是一个隧道事件（Tunneling Event），用于在按键事件到达目标元素之前捕获和处理键盘输入。它是WPF事件路由机制的一部分，与冒泡事件 KeyDown 相对应。

事件路由机制

WPF采用**隧道（Tunneling）和冒泡（Bubbling）**两种事件传播方式：

1. 隧道事件（如 PreviewKeyDown）：从根元素向下传递到目标元素，路径上的每个元素都有机会处理事件。
2. 冒泡事件（如 KeyDown）：从目标元素向上传递到根元素。

隧道事件通常用于预处理或拦截输入，而冒泡事件用于常规处理。

PreviewKeyDown 事件的用途

1. 全局按键拦截：在事件到达目标控件之前捕获按键，例如实现全局快捷键。
2. 阻止事件传播：通过设置 e.Handled = true 可以停止事件继续传递。
3. 处理特殊按键：检测修改键（如 Ctrl、Alt）或系统按键（如 Tab、Escape）。

代码示例

以下是一个简单的WPF窗口示例，演示如何处理 PreviewKeyDown 事件：

<Window x:Class="WpfApp1.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        Title="PreviewKeyDown示例" Height="300" Width="400"
        PreviewKeyDown="Window_PreviewKeyDown">
    <Grid>
        <TextBox x:Name="txtInput" HorizontalAlignment="Left" Height="23" Margin="100,100,0,0" 
                 TextWrapping="Wrap" Text="TextBox" VerticalAlignment="Top" Width="120"/>
    </Grid>
</Window>

using System.Windows;
using System.Windows.Input;

namespace WpfApp1
{
    public partial class MainWindow : Window
    {
        public MainWindow()
        {
            InitializeComponent();
        }

        private void Window_PreviewKeyDown(object sender, KeyEventArgs e)
        {
            // 检测是否按下了 Enter 键
            if (e.Key == Key.Enter)
            {
                MessageBox.Show($"你按下了 Enter 键！当前焦点控件：{Keyboard.FocusedElement}");
                
                // 阻止事件继续传播
                e.Handled = true;
            }
        }
    }
}

事件参数

PreviewKeyDown 事件传递的 KeyEventArgs 包含以下关键属性：

• Key：获取按下的键（枚举值，如 Key.Enter、Key.Escape）。
• SystemKey：获取系统键（如 Alt、F10）。
• KeyStates：获取键的状态（如按下、释放）。
• Handled：设置为 true 可阻止事件继续传递。

与 KeyDown 事件的区别

常见应用场景

1. 全局快捷键：在窗口级别捕获 Ctrl+C、F5 等组合键。
2. 输入验证：阻止特定按键输入（如禁止在数字框中输入字母）。
3. 导航控制：处理 Tab 键或方向键的特殊行为。

注意事项

• 事件处理顺序：隧道事件（PreviewXXX）总是先于冒泡事件触发。
• 性能考虑：避免在 PreviewKeyDown 中执行耗时操作，以免影响UI响应性。
• 事件取消：设置 e.Handled = true 会同时取消隧道和冒泡阶段的后续事件。

如果需要进一步定制键盘行为，可以结合 PreviewKeyUp、KeyPress（文本输入）等事件使用。

例子

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using System.Windows;
using System.Windows.Controls;
using System.Windows.Data;
using System.Windows.Documents;
using System.Windows.Input;
using System.Windows.Media;
using System.Windows.Media.Imaging;
using System.Windows.Navigation;
using System.Windows.Shapes;

namespace WpfApp2
{
    /// <summary>
    /// MainWindow.xaml 的交互逻辑
    /// </summary>
    public partial class MainWindow : Window
    {
        public MainWindow()
        {
            InitializeComponent();
        }

        private void MainWindow_event(object sender, KeyEventArgs e)
        {
            MessageBox.Show("main_window");
        }

        private void Button_event(object sender, KeyEventArgs e)
        {
            MessageBox.Show("button_window");
        }

        private void Window_KeyDown(object sender, KeyEventArgs e)
        {
            MessageBox.Show("MainWindow_被按下去");
        }

        private void Button_KeyDown(object sender, KeyEventArgs e)
        {
            MessageBox.Show("button_被按下去");
        }

        private void Grid_KeyDown(object sender, KeyEventArgs e)
        {
            MessageBox.Show("Grid_被按下去");
            e.Handled = true;
        }
    }
}

<Window x:Class="WpfApp2.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:WpfApp2"
        mc:Ignorable="d"
        Title="MainWindow" Height="450" Width="800"
        PreviewKeyDown="MainWindow_event"
        KeyDown="Window_KeyDown">
    <Grid KeyDown="Grid_KeyDown">
        <Button PreviewKeyDown="Button_event" 
                Content="hello world"
                Height="50"
                Width="80"
                KeyDown="Button_KeyDown" RenderTransformOrigin="0.5,0.5">
            <Button.RenderTransform>
                <TransformGroup>
                    <ScaleTransform/>
                    <SkewTransform/>
                    <RotateTransform Angle="38.359"/>
                    <TranslateTransform/>
                </TransformGroup>
            </Button.RenderTransform>
        </Button>
    </Grid>
</Window>