详解QMenu类的使用

QMenu 是 Qt 框架中的一个类，用于创建弹出式菜单，常用于应用程序的右键上下文菜单、工具栏按钮下拉菜单、主菜单栏等场景。

QMenu 基础使用

创建菜单

首先，创建一个 QMenu 对象：

QMenu *myMenu = new QMenu("My Menu", parentWidget); // parentWidget 是菜单所属的父窗口/控件

添加菜单项

添加普通菜单项（即 QAction）：

QAction *openAction = new QAction("Open", myMenu);
QAction *saveAction = new QAction("Save", myMenu);
myMenu->addAction(openAction);
myMenu->addAction(saveAction);

添加分隔符：

myMenu->addSeparator();

添加子菜单：

QMenu *subMenu = new QMenu("Sub Menu", myMenu);
QAction *subAction = new QAction("Sub Action", subMenu);
subMenu->addAction(subAction);
myMenu->addMenu(subMenu);

关联信号与槽

为菜单项关联触发事件（点击时执行的操作）：

connect(openAction, &QAction::triggered, this, &YourClass::openFile);
connect(saveAction, &QAction::triggered, this, &YourClass::saveFile);

其中，openFile 和 saveFile 是 YourClass 中定义的槽函数。

显示菜单

在适当的位置（如鼠标右击时）显示菜单：

QPoint pos = QCursor::pos(); // 获取当前鼠标位置
myMenu->popup(pos); // 弹出菜单

或者，如果你知道某个控件的位置，可以这样显示：

QPoint pos = widget->mapToGlobal(QPoint(0, widget->height()));
myMenu->popup(pos);

QMenu 进阶功能

设置菜单项属性

• 图标：

QIcon openIcon("path/to/open_icon.png");
openAction->setIcon(openIcon);

• 快捷键：

openAction->setShortcut(QKeySequence::Open);

• 复选状态：

QAction *toggleAction = new QAction("Toggle Option", myMenu);
toggleAction->setCheckable(true);
toggleAction->setChecked(true); // 初始状态为选中

• 禁用菜单项：

saveAction->setEnabled(false); // 禁用“保存”操作

查询菜单项状态

• 获取当前选中项：

QAction *currentAction = myMenu->exec(pos); // 弹出菜单并返回被选中的 QAction，如果没有选中项则返回 nullptr
if (currentAction) {
    qDebug() << "Selected action:" << currentAction->text();
}

• 检查特定项是否启用：

bool isSaveEnabled = saveAction->isEnabled();

其他操作

• 设置菜单对象名：

myMenu->setObjectName("MyMenu");

• 获取菜单动作：

QAction *menuAction = myMenu->menuAction(); // 获取代表整个菜单的 QAction，可用于设置图标、添加到工具栏等

• 检查菜单可见性：

bool isVisible = myMenu->isVisible();

完整代码示例

#include <QApplication>
#include <QMainWindow>
#include <QMenu>
#include <QAction>
#include <QIcon>
#include <QKeySequence>
#include <QDebug>

class MainWindow : public QMainWindow {
    Q_OBJECT

public:
    MainWindow(QWidget *parent = nullptr) : QMainWindow(parent) {
        // 创建菜单
        QMenu *fileMenu = new QMenu(tr("&File"), this);
        menuBar()->addMenu(fileMenu);

        // 添加菜单项
        QAction *openAction = new QAction(tr("&Open"), this);
        openAction->setIcon(QIcon(":/icons/open"));
        openAction->setShortcut(QKeySequence::Open);
        fileMenu->addAction(openAction);

        QAction *saveAction = new QAction(tr("&Save"), this);
        saveAction->setIcon(QIcon(":/icons/save"));
        saveAction->setShortcut(QKeySequence::Save);
        saveAction->setEnabled(false); // 初始状态下禁用“保存”操作
        fileMenu->addAction(saveAction);

        fileMenu->addSeparator();

        // 添加子菜单
        QMenu *subMenu = new QMenu(tr("Sub Menu"), this);
        QAction *subAction = new QAction(tr("Sub Action"), this);
        subMenu->addAction(subAction);
        fileMenu->addMenu(subMenu);

        // 连接信号与槽
        connect(openAction, &QAction::triggered, this, &MainWindow::openFile);
        connect(saveAction, &QAction::triggered, this, &MainWindow::saveFile);
    }

private slots:
    void openFile() {
        qDebug() << "Open file";
    }

    void saveFile() {
        qDebug() << "Save file";
    }
};

int main(int argc, char *argv[]) {
    QApplication app(argc, argv);
    MainWindow mainWindow;
    mainWindow.show();
    return app.exec();
}

以上代码展示了 QMenu 的基础使用和一些进阶功能，包括创建菜单、添加菜单项、设置属性、关联信号与槽以及查询菜单项状态等。