Qt6中QWidgetAction替代setMenu方法的实现方案咨询

由于Qt6移除了QWidgetAction::setMenu()方法，我们可以通过QMenu::setItemWidget()结合普通QAction来实现需求——给带有子菜单的动作绑定自定义控件，让菜单项既显示自定义样式，又能展开子菜单。

实现步骤 #

1. 创建自定义菜单项控件：继承QWidget，设计你需要的UI布局（比如图标、文本、子菜单箭头指示器等）。
2. 创建带子菜单的QAction：实例化QAction并通过setMenu()绑定子菜单。
3. 关联自定义控件与QAction：调用QMenu::setItemWidget()，将自定义控件设置为目标QAction对应的菜单项显示内容。
4. 处理交互事件：确保点击自定义控件时能触发子菜单展开。

代码示例 #

1. 自定义菜单项控件

#include <QWidget>
#include <QLabel>
#include <QHBoxLayout>
#include <QMouseEvent>

class CustomMenuItem : public QWidget
{
    Q_OBJECT
public:
    explicit CustomMenuItem(QWidget *parent = nullptr) : QWidget(parent) {
        // 构建自定义布局
        QHBoxLayout *layout = new QHBoxLayout(this);
        layout->setContentsMargins(8, 4, 8, 4);
        layout->setSpacing(8);

        // 自定义元素：图标、文本、子菜单箭头
        QLabel *iconLabel = new QLabel(this);
        iconLabel->setPixmap(QPixmap(":/icons/custom_icon.png").scaled(16, 16));

        QLabel *textLabel = new QLabel("自定义带子菜单的项", this);

        QLabel *arrowLabel = new QLabel(this);
        arrowLabel->setPixmap(QPixmap(":/icons/arrow_right.png").scaled(12, 12));
        arrowLabel->setAlignment(Qt::AlignRight | Qt::AlignVCenter);

        layout->addWidget(iconLabel);
        layout->addWidget(textLabel);
        layout->addStretch();
        layout->addWidget(arrowLabel);

        setLayout(layout);
        setFixedHeight(30); // 固定高度匹配菜单风格
    }

protected:
    void mousePressEvent(QMouseEvent *event) override {
        // 点击自定义控件时触发动作，展开子菜单
        if (QAction *action = menuAction()) {
            action->trigger();
        }
        QWidget::mousePressEvent(event);
    }
};

2. 主逻辑实现

#include <QMenu>
#include <QAction>
#include <QPushButton>

// 假设在某个窗口类中
void setupCustomMenu() {
    // 1. 创建主菜单
    QMenu *mainMenu = new QMenu(this);

    // 2. 创建子菜单并添加选项
    QMenu *subMenu = new QMenu("子菜单", this);
    subMenu->addAction("子选项1");
    subMenu->addAction("子选项2");
    subMenu->addSeparator();
    subMenu->addAction("子选项3");

    // 3. 创建带子菜单的动作
    QAction *customAction = new QAction(this);
    customAction->setMenu(subMenu);

    // 4. 将动作添加到主菜单
    mainMenu->addAction(customAction);

    // 5. 创建自定义控件并绑定到动作
    CustomMenuItem *customWidget = new CustomMenuItem();
    mainMenu->setItemWidget(customAction, customWidget);

    // 6. 将主菜单绑定到按钮（或菜单栏）
    ui->pushButton->setMenu(mainMenu);
}

注意事项 #

• 自定义控件的尺寸建议匹配系统菜单的默认高度，避免视觉违和。
• 若需要响应hover效果，可以重写enterEvent和leaveEvent方法，调整控件样式。
• 确保自定义控件的事件传递正常，避免子菜单无法触发或交互失效。

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