Qt 窗口悬停事件和鼠标跟踪

悬停事件

//这行代码用于启用窗口部件（widget）的悬停事件跟踪功能。
setAttribute(Qt::WA_Hover, true); 

作用

• setAttribute(Qt::WA_Hover, true); 这行代码的作用是设置窗口部件的一个属性标志，使其能够接收悬停事件（hover events）。
• 默认情况下，Qt中的窗口部件不会接收悬停事件，除非显式地启用这一功能。

属性标志 Qt::WA_Hover

• Qt::WA_Hover 是一个属性标志（attribute flag），用于指示窗口部件是否应该接收悬停事件。
• 当这个标志被设置为 true 时，窗口部件将开始接收悬停事件，如 enterEvent(), leaveEvent(), 和 hoverMoveEvent()。

注意

• 仅仅设置 Qt::WA_Hover 为 true 并不足以确保窗口部件能够接收所有悬停事件。通常，还需要确保窗口部件已经安装了事件过滤器，或者重新实现了相关的事件处理函数。
• 要接收 hoverMoveEvent()（即鼠标在窗口部件上移动时的悬停事件），除了设置 Qt::WA_Hover 为 true 外，还需要确保窗口部件的 mouseTracking 属性也被设置为 true。这可以通过调用 setMouseTracking(true); 来实现。

鼠标跟踪

        setMouseTracking 是 Qt 框架中 QWidget 类的一个成员函数，用于控制小部件（widget）是否接收鼠标移动事件，即使在没有按下鼠标按钮的情况下。这个函数对于需要实时跟踪鼠标位置的应用程序特别有用，比如绘图应用、游戏等界面。 

//原型：
void QWidget::setMouseTracking(bool enable);

参数：一个布尔值，用于指定是否启用鼠标跟踪。

• true：启用鼠标跟踪，使得小部件能够接收鼠标移动事件（mouseMoveEvent），无论鼠标按钮是否被按下。
• false：禁用鼠标跟踪（默认值），小部件仅在鼠标按钮被按下时接收鼠标移动事件。 

成员函数详解

• 作用范围：setMouseTracking 仅影响当前调用它的小部件及其子小部件（如果子小部件没有单独设置鼠标跟踪的话）。但是，请注意，如果子小部件有自己的鼠标事件处理逻辑，并且它们调用了自己的 setMouseTracking，那么它们的行为将独立于父小部件。
• 事件类型：setMouseTracking 仅影响鼠标移动事件（mouseMoveEvent）。其他类型的鼠标事件（如鼠标按下、释放、双击、滚轮等）不受此函数的影响。这些事件将按照 Qt 的默认事件分发机制进行处理。
• 性能考虑：启用鼠标跟踪会增加事件处理的开销，因为系统需要不断地发送鼠标移动事件到小部件。在包含大量小部件的大型应用程序中，这可能会导致性能问题。因此，建议在确实需要跟踪鼠标移动时才启用它。

// 假设有一个QWidget子类实例名为myWidget  
myWidget->setAttribute(Qt::WA_Hover, true);  
myWidget->setMouseTracking(true); // 确保能够接收hoverMoveEvent()  
  
// 重新实现hoverMoveEvent()以处理悬停移动事件  
protected:  
    void hoverMoveEvent(QHoverEvent *event) override {  
        // 处理悬停移动事件的代码  
        qDebug() << "Hover moved to:" << event->pos();  
    }