WPF 单击与双击操作区分

jgrass

发布于 2024-12-25 10:26:23

30800

代码可运行

文章被收录于专栏：蔻丁杂记蔻丁杂记

运行总次数：0

代码可运行

背景

如果不需要严格区分单击与双击操作，可以直接通过 MouseButtonEventArgs 中的 ClickCount 属性来进行判断。

private void MyMouseDownHandler(object sender, MouseButtonEventArgs e){    if (e.ClickCount == 2)    {        // Handle double-click    }}

但上述写法有个问题是，如果我需要在单击和双击时执行不同的操作，则无法满足需求。因为用户双击时，会首先触发一次 e.ClickCount == 1 的单击。

mouseevent - Distinguish between mouse doubleclick and mouse click in wpf - Stack Overflow

实现

using System;using System.Windows.Input;using System.Windows.Threading;
namespace xxx.xxx;
/// <summary>/// 通过延迟判断来区分鼠标单击和双击操作，/// 对于需要严格区分单击和双击的场景使用。/// 影响：单击的响应会有延迟，延迟 220 ms/// </summary>internal class MouseDoubleClickHelper{    private static readonly TimeSpan DoubleClickCheckTime = TimeSpan.FromMilliseconds(220); // ms
    private DateTime _lastClickTime = DateTime.MinValue;
    private readonly DispatcherTimer _timer;
    /// <summary>    /// 单击时的动作    /// </summary>    public Action<object, MouseButtonEventArgs>? ClickAction { get; set; }
    /// <summary>    /// 双击时的动作    /// </summary>    public Action<object, MouseButtonEventArgs>? DoubleClickAction { get; set; }
    public MouseDoubleClickHelper(Dispatcher dispatcher)    {        _timer = new DispatcherTimer(DoubleClickCheckTime, DispatcherPriority.Input, TimerCallback, dispatcher);    }
    private void TimerCallback(object? _, EventArgs __)    {        // ReSharper disable once UsePatternMatching        var args = _timer.Tag as (object sender, MouseButtonEventArgs e)?;
        if (args != null)        {            // 计时器到，没有出现第二次点击，则认为是单击动作，执行单击操作            ClickAction?.Invoke(args.Value.sender, args.Value.e);            _timer.Tag = null;        }    }
    /// <summary>    /// 鼠标点击时调用    /// </summary>    public void OnMouseDown(object sender, MouseButtonEventArgs e)    {        var now = DateTime.Now;        var span = now - _lastClickTime;
        if (span > DoubleClickCheckTime)        {            // 首次点击，不立即执行，启动计时器，延迟执行            _timer.Tag = (sender, e);            _timer.Start();        }        else if (span <= DoubleClickCheckTime)        {            // 停掉单击的执行            _timer.Tag = null;            _timer.Stop();            if (e.ClickCount == 2)            {                // 执行双击动作                DoubleClickAction?.Invoke(sender, e);            }        }
        _lastClickTime = now;    }}

通过延迟判断，来过滤掉双击时，第一次鼠标点击的触发。

带来的问题是，正常的单击操作，会被延迟触发。

如果你期望使用更精确的 DoubleClickCheckTime，可以使用 System.Windows.Forms.SystemInformation.DoubleClickTime

SystemInformation.DoubleClickTime 属性 (System.Windows.Forms) | Microsoft Learn

在 WPF 中，需要先添加 WindowForms 的引用。

<Project Sdk="Microsoft.NET.Sdk">  <PropertyGroup>    <TargetFramework>net8.0-windows</TargetFramework>    <ImplicitUsings>enable</ImplicitUsings>    <Nullable>enable</Nullable>    <UseWPF>true</UseWPF>    <UseWindowsForms>true</UseWindowsForms>  </PropertyGroup></Project>