详解QMenu类的使用

2024-04-14 18:12

文章标签 使用详解 qmenu

本文主要是介绍详解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_OBJECTpublic: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();
}