Qt自定义双击事件实现方案（规避原生双击附带单击问题）

1. 文档概述

1.1 背景

Qt原生双击事件（QMouseEvent::DoubleClick）存在固有缺陷：触发双击时会先后触发两次单击事件（实测触发顺序为「单击1 → 双击 → 单击2」），导致业务逻辑中出现"双击+两次单击"的冗余触发。在视频回放场景中，该问题会造成"双击播放视频"操作附带执行两次"单击切换视频并暂停"逻辑，严重破坏交互体验。

1.2 解决方案

通过「文件一致性判定 + 时间戳间隔判定」自定义实现双击逻辑，完全抛弃原生双击事件，既规避了冗余单击触发问题，又保证双击交互体验与Qt原生双击事件完全一致。

1.3 适用场景

Windows平台下Qt视频回放窗口，需实现「单击切换视频并暂停、双击播放当前视频」的交互场景。

2. 核心设计逻辑

2.1 判定规则

自定义双击需同时满足以下两个条件，否则判定为单击：

|-------|----------------------------|------------------------------------------------------------------------------------|
| 判定维度 | 判定逻辑 | 变量/说明 |
| 文件一致性 | 两次点击是否为同一个视频文件 | pathNotChange：<br>- true：同一文件；<br>- false：不同文件（视为两次独立单击） |
| 时间间隔 | 两次点击间隔是否小于0.5秒（Qt原生双击默认间隔） | isShort：<br>- true：间隔<500ms（判定为双击）；<br>- false：间隔≥500ms（视为对同一文件的两次独立单击） |

2.2 交互逻辑

|------|---------------------------------------------|------------------------------------------------------------|
| 操作类型 | 判定条件 | 业务行为 |
| 双击 | pathNotChange = true + isShort = true | 执行slotPlay()播放当前暂停的视频 |
| 单击 | pathNotChange = false 或 isShort = false | 执行slotStartVideoPlay(name)切换视频，随后通过定时器执行slotPlay()立即暂停 |

3. 代码实现

3.1 头文件（ReplayWindow.h）

仅声明核心时间戳变量，用于记录单击时间以区分单击/双击：

复制代码

//!< 单击时间记录，用来区分单击和双击
qint64 clickTime = 0;

3.2 源文件（ReplayWindow.cpp）

核心判定逻辑实现，无冗余判断，贴合业务场景：

复制代码

void ReplayWindow::slotVideoClicked(QString name)
{
    // 判定是否点击同一个视频文件
    bool pathNotChange = m_curVideoPath.contains(name);
    // 获取当前点击的毫秒级时间戳
    qint64 currentTime = QDateTime::currentMSecsSinceEpoch();
    // 判定两次点击间隔是否小于0.5秒
    bool isShort = (currentTime - this->clickTime) < 500;
    
    // 更新点击时间戳（避免业务逻辑执行耗时影响下一次判定）
    this->clickTime = currentTime;

    // 双击：同一文件且间隔<0.5秒，播放当前视频
    if(pathNotChange && isShort){
        this->slotPlay();
    }
    // 单击：文件不同 或 间隔≥0.5秒，切换视频并暂停
    else{
        this->slotStartVideoPlay(name);
        QTimer::singleShot(0, this, &ReplayWindow::slotPlay);
    }
}

4. 核心优势

4.1 彻底解决原生双击冗余单击问题

自定义实现仅基于单次单击事件完成判定，完全规避Qt原生双击「单击1 → 双击 → 单击2」的冗余触发顺序，无需编写复杂的事件屏蔽逻辑。

4.2 体验与Qt原生双击完全一致

时间间隔采用Qt原生双击默认的500ms阈值，符合用户操作习惯；
判定逻辑遵循Qt原生双击"同一目标+短间隔"的核心规则，用户无感知差异。

4.3 代码简洁且健壮

仅通过一个时间戳变量clickTime完成间隔判定，无多余依赖；
提前更新时间戳，避免业务逻辑（如视频加载）执行耗时导致的判定偏差；
QTimer::singleShot(0)保证视频加载完成后执行暂停，规避时序问题。

5. 总结

本方案通过「文件一致性+500ms时间间隔」的自定义判定逻辑，彻底解决Qt原生双击附带两次单击的核心问题；
代码极简且逻辑内聚，无需抽离工具类，仅通过一个时间戳变量即可实现双击/单击的精准区分；
交互体验与Qt原生双击完全一致，适配视频回放等需精准区分单击/双击行为的业务场景。