当前位置：首页 > news >正文

Qt应用开发(基础篇)——菜单 QMenu

news 2026/5/24 9:26:22

一、前言

QMenu类继承于QWidget，它提供了一个菜单样式的小部件，用于菜单栏、上下文菜单和一些弹出式菜单。

QMenu菜单的选项是可选的，它可以是一个下拉的菜单，也可以是独立的上下文菜单。下拉菜单通常作用于当用户单击相应的项目或按下指定的快捷键时，使用QMenuBar::addMenu()将菜单插入到菜单栏中，菜单栏将显示下拉菜单。上下文菜单通常通过一些特殊的键盘键或右键来调用。它们可以用popup()异步执行，也可以用exec()同步执行。当然菜单也可以在一些触发事件中调用，比如按下按钮时。

QMenu菜单由一系列操作项QAcion组成，QAcion在QMenu调用addAction()、addActions()、insertAction()的时候添加，动作垂直表示，样式由QStyle呈现。此外，操作可以有一个文本标签，在最左边绘制一个可选的图标，以及快捷键序列。

void MainWindow::on_pushButton_clicked()
{QMenu *menu = new QMenu();                menu->addAction(QIcon(QApplication::style()->standardIcon(QStyle::SP_DirOpenIcon)),"copy");menu->addAction("cut");menu->addAction("paste");menu->popup(QPoint(this->pos().x()+100,this->pos().y()+100));
}

QMenu菜单有四种类型的操作项:分隔符、子菜单、小部件和执行操作。使用addSeparator()插入分隔符，使用addMenu()插入子菜单。当插入动作项时，通常指定一个接收器和插槽，此外，QMenu提供了两个信号，triggered()和hover()，它们向从菜单触发的QAction发出信号，我们也可以从这里知道哪个QAction被触发。

在下面的示例中，我们指定copy动作的同时定义信号槽，并且绑定menu的triggered信号，点击copy就会打印“copy Triggered”两次。

警告:要使QMenu在软件上可见，应该使用exec()或popup()而不是show()。如果使用show()，没有指定坐标的情况下，菜单会直接显示屏幕的左上角。

void MainWindow::on_pushButton_clicked()
{
QMenu *menu = new QMenu();                
QAction *copyAcy = menu->addAction(QIcon(QApplication::style()->standardIcon(QStyle::SP_DirOpenIcon)),"copy",this,SLOT(onCopyTriggered()),QKeySequence(Qt::CTRL + Qt::Key_C));
menu->addAction("cut");
menu->addSeparator();
QMenu *sub_menu = new QMenu("help");
menu->addMenu(sub_menu);
menu->addMenu(sub_menu);
sub_menu->addAction("about");
menu->popup(QPoint(this->pos().x()+100,this->pos().y()+100));connect(menu,&QMenu::triggered,[=](QAction *action *action){if(action == copyAcy){qDebug()<<"copy Triggered";}});
}void MainWindow::onCopyTriggered()
{qDebug()<<"copy Triggered";
}

二、QMenu类

1、icon

该属性表示菜单的选项图标，默认是一个空的图标。

bool autoRepeat() const
void setAutoRepeat(bool)

在上面的实例我们添加一句：

sub_menu->setIcon(QIcon(QApplication::style()->standardIcon(QStyle::SP_DirOpenIcon)));

2、separatorsCollapsible

该属性表示是否连续分隔符是否应在视觉上折叠为单个分隔符，菜单开头或结尾的分隔符也被隐藏，该属性默认为true。

3、tearOffEnabled

该属性表示菜单是否可以被撕下，当为true时，菜单包含一个特殊的可撕毁项(通常显示为菜单顶部的虚线)。用户可以“撕掉”经常使用的菜单，该项在触发时创建菜单的副本。这个“撕下来的”副本位于屏幕上一个单独的窗口中。这个概念通常不会在微软Windows上使用，所以我们一般也不回使用，当做了解就行了。此属性默认为false。

bool isTearOffEnabled() const
void setTearOffEnabled(bool)

4、title

该属性表示菜单的标题，默认情况下是一个空的字符串，所以不显示。

QString title() const
void setTitle(const QString &title)

5、toolTipsVisible

该属性表示是否要显示工具提示，默认为false。

bool toolTipsVisible() const
void setToolTipsVisible(bool visible)

QAction *copyAcy = menu->addAction(QIcon(QApplication::style()->standardIcon(QStyle::SP_DirOpenIIcon)),"copy",this,SLOT(onCopyTriggered()),QKeySequence(Qt::CTRL + Qt::Key_C));
copyAcy->setToolTip("this is copy");

6、公共函数

1）addAction

添加动作QAction，返回QAction指针，可以传入文本，图标，触发响应的槽函数和按键快捷方式。

QAction *addAction(const QString &text)
QAction *addAction(const QIcon &icon, const QString &text)
QAction *addAction(const QString &text, const QObject *receiver, const char *member, const QKeySequence &shortcut = 0)
QAction *addAction(const QIcon &icon, const QString &text, const QObject *receiver, const char *member, const QKeySequence &shortcut = 0)
QAction *addAction(const QString &text, Functor functor, const QKeySequence &shortcut = 0)
QAction *addAction(const QString &text, const QObject *context, Functor functor, const QKeySequence &shortcut = 0)
QAction *addAction(const QIcon &icon, const QString &text, Functor functor, const QKeySequence &shortcut = 0)
QAction *addAction(const QIcon &icon, const QString &text, const QObject *context, Functor functor, const QKeySequence &shortcut = 0)

2）actionAt

返回指定坐标pos下的QAction指针，如果不存在则返回空指针。

QAction *actionAt(const QPoint &pt) const

3）actionGeometry

返回指定坐标pos下的QAction指针，如果不存在则返回空指针。

QRect actionGeometry(QAction *act) const

4）activeAction

返回当前高亮显示的QAction指针，如果当前没有高亮显示的操作，则返回空指针。

QAction *activeAction() const

5）setActiveAction

设置指定的QAction为高亮。

void setActiveAction(QAction *act)

6）defaultAction

返回当前默认的QAction指针。

QAction *defaultAction() const

7）setDefaultAction

返回某QAction为默认操作，默认操作会有一个视觉提示，通常表示在发生删除时默认会发生什么。

QAction *defaultAction() const

8）addMenu

添加子菜单，参考上文示例。

QAction *addMenu(QMenu *menu)
QMenu *addMenu(const QString &title)
QMenu *addMenu(const QIcon &icon, const QString &title)

9）insertMenu

在before之前插入菜单。

QAction *insertMenu(QAction *before, QMenu *menu)

10）addSection

添加section动作，样式是一个分隔符带文本和图标，返回QAction指针。就好像一个QAction::setSeparator(true)但是又有文本和图标提示的动作。样式取决与系统的GUI样式。

QAction *addSection(const QString &text)
QAction *addSection(const QIcon &icon, const QString &text)

QMenu *menu = new QMenu();
menu->addAction(QIcon(QApplication::style()->standardIcon(QStyle::SP_DirOpenIcon)),"copy");
menu->addSection("handle");
menu->addAction("cut");
menu->addAction("paste");

11）insertSection

在before之前插入seciton动作。

QAction *insertSection(QAction *before, const QString &text)
QAction *insertSection(QAction *before, const QIcon &icon, const QString &text)

12）addSeparator

添加分隔符。

QAction *addSeparator()

13）addSeparator

在before之前插入分隔符。

QAction *insertSeparator(QAction *before)

14）exec

同步执行此菜单，相当于exec(pos())。返回在弹出菜单或其子菜单中触发的QAction，如果没有触发项(通常是因为用户按了Esc)，则返回空指针。

QAction *exec()
QAction *exec(const QPoint &p, QAction *action = nullptr)
//静态函数
QAction *exec(QList<QAction *> actions, const QPoint &pos, QAction *at = nullptr, QWidget *parent = nullptr)

在大多数情况下，需要自己指定位置，比如:

exec(QCursor::pos());
exec(somewidget.mapToGlobal(QPoint(0,0)));
exec(e->globalPos());

15）popup

显示菜单，使动作atAction位于指定的全局位置p。

void popup(const QPoint &p, QAction *atAction = nullptr)

16）clear

删除所有菜单的操作。

void clear()

17）isEmpty

返回菜单操作项数量是否为空。

bool isEmpty() const

18）setAsDockMenu

通过选项单击应用程序dock图标，将此菜单设置为可用的dock菜单。仅在macOS上可用。

void setAsDockMenu()

19）menuAction

返回与此菜单关联的QAction指针

QAction *menuAction() const

7、信号

1）hovered

该信号在菜单操作被高亮显示时触发，action是触发信号的动作，通常用于更新状态信息。

void hovered(QAction *action)

2）triggered

该信号在触发此菜单中的操作时触发，action是触发信号的动作，通常将每个菜单动作的触发器()信号连接到它自己的自定义槽，但有时你会想要将几个动作连接到一个槽，例如，当你有一组密切相关的动作，如“左对齐”，“居中”，“右对齐”。

void triggered(QAction *action)

3）aboutToShow

该信号在菜单显示的时候触发。

void aboutToShow()

4）aboutToHide

该信号在菜单隐藏的时候触发。

void aboutToHide()