8.WPFTextBox控件的鼠标和键盘事件

在 WPF 中配置 TextBox 的鼠标和键盘事件是构建交互式应用的关键。以下是详细的配置方法和实用技巧：

---

🖱 鼠标事件配置

常用鼠标事件

事件	触发时机	典型应用场景
MouseEnter	鼠标进入控件区域	高亮提示
MouseLeave	鼠标离开控件区域	恢复默认状态
MouseDown	鼠标按键按下	拖拽开始
MouseUp	鼠标按键释放	拖拽结束
MouseMove	鼠标在控件上移动	实时坐标追踪
MouseDoubleClick	双击控件	快速编辑/全选

配置示例

<TextBox 
    MouseEnter="TextBox_MouseEnter"
    MouseLeave="TextBox_MouseLeave"
    MouseDown="TextBox_MouseDown"
    MouseDoubleClick="TextBox_DoubleClick"
    Name="myTextBox"/>

// 鼠标悬浮效果
private void TextBox_MouseEnter(object sender, MouseEventArgs e)
{
    myTextBox.Background = Brushes.LightYellow;
    myTextBox.BorderBrush = Brushes.Blue;
}

// 鼠标离开恢复
private void TextBox_MouseLeave(object sender, MouseEventArgs e)
{
    myTextBox.Background = Brushes.White;
    myTextBox.BorderBrush = SystemColors.ControlDarkBrush;
}

// 鼠标按下记录位置
private Point _dragStartPoint;
private void TextBox_MouseDown(object sender, MouseButtonEventArgs e)
{
    _dragStartPoint = e.GetPosition(null);
}

// 双击全选文本
private void TextBox_DoubleClick(object sender, MouseButtonEventArgs e)
{
    myTextBox.SelectAll();
}

---

⌨ 键盘事件配置

核心键盘事件

事件	触发时机	特殊说明
PreviewKeyDown	按键按下（路由隧道事件）	在KeyDown之前触发
KeyDown	按键按下（路由冒泡事件）	处理物理按键
PreviewKeyUp	按键释放（隧道事件）
KeyUp	按键释放（冒泡事件）
PreviewTextInput	文本输入前	过滤字符输入
TextChanged	文本内容变化	内容实时验证

键盘事件处理技巧

// 拦截特定按键（如阻止回车换行）
private void TextBox_PreviewKeyDown(object sender, KeyEventArgs e)
{
    // 回车键提交内容
    if (e.Key == Key.Enter)
    {
        SubmitContent();
        e.Handled = true; // 阻止默认换行行为
    }
    
    // Ctrl+S保存
    if (e.Key == Key.S && Keyboard.Modifiers == ModifierKeys.Control)
    {
        SaveDocument();
        e.Handled = true;
    }
}

// 输入内容过滤（只允许数字）
private void TextBox_PreviewTextInput(object sender, TextCompositionEventArgs e)
{
    if (!char.IsDigit(e.Text, e.Text.Length - 1))
        e.Handled = true;
}

// 实时文本验证
private void TextBox_TextChanged(object sender, TextChangedEventArgs e)
{
    if (myTextBox.Text.Length > 100)
    {
        myTextBox.Background = Brushes.LightPink;
        ShowWarning("超过最大长度限制！");
    }
    else
    {
        myTextBox.Background = Brushes.White;
    }
}

---

⚡ 高级交互技巧

1. 组合事件处理（拖拽示例）

private bool _isDragging;
private Point _startPosition;

private void TextBox_MouseDown(object sender, MouseButtonEventArgs e)
{
    _isDragging = true;
    _startPosition = e.GetPosition(null);
    myTextBox.CaptureMouse(); // 捕获鼠标
}

private void TextBox_MouseMove(object sender, MouseEventArgs e)
{
    if (!_isDragging) return;
    
    Point currentPos = e.GetPosition(null);
    Vector diff = _startPosition - currentPos;
    
    // 移动逻辑（如关联滚动条）
    scrollViewer.ScrollToVerticalOffset(scrollViewer.VerticalOffset + diff.Y);
    _startPosition = currentPos;
}

private void TextBox_MouseUp(object sender, MouseButtonEventArgs e)
{
    _isDragging = false;
    myTextBox.ReleaseMouseCapture(); // 释放鼠标
}

2. 快捷键系统集成

// 在Window构造函数中注册全局快捷键
public MainWindow()
{
    InitializeComponent();
    
    // Ctrl+空格清空文本框
    var clearCommand = new RoutedCommand();
    clearCommand.InputGestures.Add(new KeyGesture(Key.Space, ModifierKeys.Control));
    CommandBindings.Add(new CommandBinding(clearCommand, (s, e) => myTextBox.Clear()));
}

3. 输入法处理（IME支持）

// 启用IME输入模式
myTextBox.ImeMode = System.Windows.Input.ImeMode.On;

// IME状态变更事件
myTextBox.TextInputStart += (s, e) => 
{
    Debug.WriteLine("IME输入开始");
};

---

🛡 最佳实践

1. 事件选择优先级：

   • 需要拦截操作 → 用 PreviewXXX 事件（隧道事件）
   • 需要响应操作 → 用标准事件（冒泡事件）
   • 内容变化 → TextChanged（非键盘专属事件）

2. 性能优化：

   // 高频事件（如TextChanged）使用延迟处理
   private DispatcherTimer _validationTimer;
   private void TextBox_TextChanged(object sender, TextChangedEventArgs e)
   {
       _validationTimer?.Stop();
       _validationTimer = new DispatcherTimer 
       { 
           Interval = TimeSpan.FromMilliseconds(500) 
       };
       _validationTimer.Tick += (s, _) => ValidateInput();
       _validationTimer.Start();
   }

3. 事件解耦模式：

   // 使用命令绑定代替事件处理
   <TextBox>
       <TextBox.CommandBindings>
           <CommandBinding Command="ApplicationCommands.Paste" 
                           Executed="PasteCommand_Executed"
                           CanExecute="PasteCommand_CanExecute"/>
       </TextBox.CommandBindings>
   </TextBox>

4. 无障碍支持：

   // 为键盘导航添加提示
   ToolTipService.SetShowDuration(myTextBox, 5000);
   myTextBox.ToolTip = "按Ctrl+Enter提交内容";

---

⚠ 常见问题解决

1. 事件不触发检查：

   • 确认 IsHitTestVisible="True"
   • 检查上层元素是否拦截事件（e.Handled=true）
   • 验证 Focusable="True"

2. KeyDown vs TextInput：

   • KeyDown：响应物理按键（如F1、方向键）
   • TextInput：响应字符输入（已考虑输入法组合）

通过合理配置这些事件，可以实现从基础表单验证到复杂文本编辑器的全方位交互功能。