如何通过鼠标悬停事件切换StackWidget页面？按钮实现成功组件失败

问题核心原因 #

QStackWidget默认未开启鼠标追踪，仅在鼠标按下时才会响应鼠标事件，这是导致你用eventFilter无法捕获悬停事件的关键；另外如果StackWidget被子部件完全覆盖，事件会被子部件拦截，也会导致失效。

解决步骤及代码示例 #

1. 开启鼠标追踪

在初始化时给StackWidget开启鼠标追踪，确保无鼠标按下时也能接收鼠标事件：

// 假设你的StackWidget对象是ui->stackWidget
ui->stackWidget->setMouseTracking(true);

2. 安装事件过滤器并实现逻辑

给StackWidget安装事件过滤器，重写eventFilter函数处理悬停相关事件：

// 在类头文件中声明重写eventFilter
class MainWindow : public QMainWindow
{
    Q_OBJECT
public:
    explicit MainWindow(QWidget *parent = nullptr);
    ~MainWindow();
private:
    Ui::MainWindow *ui;
    bool eventFilter(QObject *watched, QEvent *event) override; // 声明重写
};

// 实现eventFilter函数
bool MainWindow::eventFilter(QObject *watched, QEvent *event)
{
    if (watched == ui->stackWidget) {
        // 鼠标进入StackWidget区域时切换页面
        if (event->type() == QEvent::Enter) {
            ui->stackWidget->setCurrentIndex(1); // 切换到索引为1的页面
        }
        // 鼠标离开时切回原页面
        else if (event->type() == QEvent::Leave) {
            ui->stackWidget->setCurrentIndex(0); // 切回索引为0的页面
        }
        // 进阶：按鼠标位置切换不同页面（比如左右分栏）
        else if (event->type() == QEvent::MouseMove) {
            QMouseEvent *mouseEvt = static_cast<QMouseEvent*>(event);
            int halfWidth = ui->stackWidget->width() / 2;
            if (mouseEvt->pos().x() < halfWidth) {
                ui->stackWidget->setCurrentIndex(0);
            } else {
                ui->stackWidget->setCurrentIndex(1);
            }
        }
    }
    // 传递未处理的事件给父类
    return QMainWindow::eventFilter(watched, event);
}

3. 初始化时安装过滤器

在构造函数中完成事件过滤器的安装：

MainWindow::MainWindow(QWidget *parent) :
    QMainWindow(parent),
    ui(new Ui::MainWindow)
{
    ui->setupUi(this);
    ui->stackWidget->setMouseTracking(true);
    ui->stackWidget->installEventFilter(this); // 安装过滤器
}

额外注意事项 #

• 如果StackWidget的子页面完全覆盖了父部件，子页面会拦截鼠标事件，此时需要给子页面也安装事件过滤器，或者在子页面的event函数中调用parentWidget()->event(event)将事件传递给StackWidget。
• 若需要更复杂的悬停逻辑（比如悬停特定区域切换对应页面），可以通过QMouseEvent::pos()获取鼠标在StackWidget内的坐标，结合区域判断实现。

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