MAUI中单双击事件冲突：如何避免双击时触发单击方法？

当同时给控件添加单击（NumberOfTapsRequired="1"）和双击（NumberOfTapsRequired="2"）手势时，双击操作会触发两次单击事件+一次双击事件——这是因为系统会先识别单次点击，再判定是否为双击。要避免这种情况，可以通过延迟判断的方式区分单击和双击：

步骤1：在页面类中添加变量 #

在MainPage.xaml.cs里定义用于计数和延迟判定的变量：

private int _tapCount;
private Timer _tapTimer;
// 双击判定延迟，可根据交互习惯调整，一般300毫秒左右
private const int DoubleTapDelay = 300;

步骤2：修改单击事件逻辑 #

不要直接在单击事件里执行业务代码，而是通过计时器等待，确认是否有后续第二次点击：

private void OnSingleTap(object sender, EventArgs e)
{
    _tapCount++;
    if (_tapCount == 1)
    {
        _tapTimer = new Timer(DoubleTapDelay);
        _tapTimer.Elapsed += (s, args) =>
        {
            // 延迟结束后如果还是单次点击，才执行单击逻辑
            if (_tapCount == 1)
            {
                // 回到UI线程执行操作
                MainThread.BeginInvokeOnMainThread(() =>
                {
                    // 替换成你的单击业务代码
                    Console.WriteLine("执行单击操作");
                });
            }
            // 重置计数并释放计时器
            _tapCount = 0;
            _tapTimer.Dispose();
        };
        _tapTimer.Start();
    }
}

步骤3：修改双击事件逻辑 #

双击触发时，立即重置计数并停止计时器，直接拦截单击逻辑的执行：

private void OnDoubleTap(object sender, EventArgs e)
{
    // 清空计数，终止计时器
    _tapCount = 0;
    _tapTimer?.Stop();
    _tapTimer?.Dispose();
    // 替换成你的双击业务代码
    Console.WriteLine("执行双击操作");
}

XAML部分保持不变 #

你的手势定义无需修改：

<Image Source="dotnet_bot.png">
    <Image.GestureRecognizers>
        <TapGestureRecognizer NumberOfTapsRequired="1" Tapped="OnSingleTap"/>
        <TapGestureRecognizer NumberOfTapsRequired="2" Tapped="OnDoubleTap"/>
    </Image.GestureRecognizers>
</Image>

这个方法的核心是：通过短延迟等待用户的后续操作，只有在确认没有第二次点击时才执行单击逻辑，彻底避免双击触发单击事件的问题。

内容的提问来源于stack exchange，提问作者mattica