基本Widgets(29)：【类】QMenu [官翻]

已于 2023-12-09 22:54:16 修改
阅读量1.1k 收藏 8
点赞数
分类专栏： # Qt Widgets 文章标签： qt 开发语言
于 2021-01-29 11:57:24 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/hitzsf/article/details/113376603
版权

文章目录

QMenu Class

QMenu类提供了一个用于菜单栏、上下文菜单和其他弹出菜单的菜单小部件。

Header#include < QLineEdit >
qmakeQT += widgets
InheritsQWidget
Inherited By

详细说明

img

菜单小部件是一个选择菜单。它可以是菜单栏中的下拉菜单，也可以是独立的上下文菜单。当用户单击相应的项目或按指定的快捷键时，下拉菜单由菜单栏显示。使用QMenuBar::addMenu() 将菜单插入菜单栏。上下文菜单通常由一些特殊的键盘键或右键单击来调用。它们可以通过popup() 异步执行，也可以通过exec() 同步执行。菜单也可以响应按钮的按下而被调用；除了如何调用它们之外，它们与上下文菜单一样。

操作(Actions)

菜单由操作项列表组成。操作是通过addAction() 、addActions() 和insertAction() 函数添加的。操作是垂直表示的，并由QStyle呈现。此外，操作可以有文本标签、在最左侧绘制的可选图标和快捷键序列，如“Ctrl+X”。

菜单中的现有操作可以通过actions() 找到。

有四种操作项:分隔符、显示子菜单的操作、小部件和执行操作的操作。分隔符与addSeparator() 一起插入，子菜单与addMenu() 一起插入，所有其他项都被视为操作项。

当插入操作项时，您通常指定一个接收器和一个插槽。当项目被 triggered() 时，接收者将被通知。此外，QMenu提供了两个信号，triggered()和hover()，它们向从菜单中触发的QAction发出信号。

使用clear() 清除菜单，并使用removeAction() 删除单个操作项。

QMenu也可以提供分离式菜单。分离式菜单是一个顶层窗口，它包含菜单的副本。这使得用户可以“tear off”经常使用的菜单，并将它们放置在屏幕上一个方便的位置。如果您希望将此功能用于特定菜单，可以使用setTearOffEnabled()插入一个分离句柄。当使用分离式菜单时，请记住，这个概念通常不会在微软Windows上使用，所以一些用户可能不熟悉它。考虑使用QToolBar代替。

小部件可以通过QWidgetAction类插入菜单。这个类的实例用于保存小部件，并通过采用QAction的addAction() 重载插入到菜单中。如果QWidgetAction触发triggered() 信号，菜单将关闭。

警告:要使QMenu在屏幕上可见，应使用exec() 或popup() 而不是show() 。

基于Cocoa的Qt构建macOS上的QMenu

QMenu只能在菜单/菜单栏中插入一次。后续的插入将没有效果，或者将导致禁用菜单项。

有关如何在应用程序中使用QMenuBar和QMenu的示例，请参阅菜单示例。

重要的继承函数:addAction()、removeAction()、clear()、addSeparator()和addMenu()。

属性

  1. icon: QIcon 菜单的图标

    这相当于menuAction() 的QAction::icon属性。

    默认情况下，如果未显式设置图标，则此属性包含空图标。

    访问功能:

    • QIcon icon() const
    • void setIcon(const QIcon &icon)

  2. separatorsCollapsible: bool 是否应折叠连续分隔符

    此属性指定是否应将菜单中的连续分隔符可视地折叠为单个分隔符。菜单开头或结尾的分隔符也被隐藏。
    默认情况下，此属性为true。

    访问功能:

    • bool separatorsCollapsible() const
    1. void setSeparatorsCollapsible(bool collapse)

  3. tearOffEnabled: bool 菜单是否支持撕开
    如果为true，则菜单包含一个特殊的删除项（通常在菜单顶部显示为虚线），该项在触发菜单时创建菜单的副本。
    这个“撕下来的”拷贝放在一个单独的窗口中。它包含与原始菜单相同的菜单项，除了可拆卸手柄。
    默认情况下，此属性为false。

    访问功能:

    • bool isTearOffEnabled() const
    1. void setTearOffEnabled(bool)

  4. title: QString 菜单的标题

    访问功能:

    • QString title() const
    1. void setTitle(const QString &title)

  5. toolTipsVisible: bool 菜单操作的工具提示是否应可见
    此属性指定操作菜单项是否显示其工具提示。
    默认情况下，此属性为false。

    访问功能:

    • bool toolTipsVisible() const
    1. void setToolTipsVisible(bool visible)

    [外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-STbUFyxa-1611892586591)(https://gitee.com/shenjiguicang/test/raw/master/images/20210129103334.png)]

公共函数

构造和析构

  1. QMenu(const QString &title, QWidget *parent = nullptr)
  2. QMenu(QWidget *parent = nullptr)
  3. virtual ~QMenu()

属性相关

  1. QIcon icon() const
  2. void setIcon(const QIcon &icon)
  3. bool separatorsCollapsible() const
  4. void setSeparatorsCollapsible(bool collapse)
  5. bool isTearOffEnabled() const
  6. void setTearOffEnabled(bool)
  7. QString title() const
  8. void setTitle(const QString &title)
  9. bool toolTipsVisible() const
  10. void setToolTipsVisible(bool visible)

活动和默认操作

  1. QAction * activeAction() const
  2. void setActiveAction(QAction *act)
  3. QAction * defaultAction() const
  4. void setDefaultAction(QAction *act)

位置上的操作和操作的几何大小

  1. QAction * actionAt(const QPoint &pt) const
  2. QRect actionGeometry(QAction *act) const

添加操作项

便利函数使用文本创建新操作。函数将新创建的操作添加到菜单的操作列表中，并返回它。
QMenu拥有返回的QAction的所有权。

  1. QAction * addAction(const QString &text)
  2. QAction * addAction(const QIcon &icon, const QString &text)
  3. QAction * addAction(const QString &text, const QObject *receiver, const char *member, const QKeySequence &shortcut = 0)
  4. QAction * addAction(const QIcon &icon, const QString &text, const QObject *receiver, const char *member, const QKeySequence &shortcut = 0)
  5. QAction * addAction(const QString &text, Functor functor, const QKeySequence &shortcut = 0)
  6. QAction * addAction(const QString &text, const QObject *context, Functor functor, const QKeySequence &shortcut = 0)
  7. QAction * addAction(const QIcon &icon, const QString &text, Functor functor, const QKeySequence &shortcut = 0)
  8. QAction * addAction(const QIcon &icon, const QString &text, const QObject *context, Functor functor, const QKeySequence &shortcut = 0)

增加子菜单

添加子菜单。它返回menu的menuAction() 。此容器菜单不拥有子菜单的所有权。

  1. QAction * addMenu(QMenu *menu)
  2. QMenu * addMenu(const QString &title)
  3. QMenu * addMenu(const QIcon &icon, const QString &title)
  4. QAction * insertMenu(QAction *before, QMenu *menu)
  5. QAction * menuAction() const 返回与此菜单关联的操作

增加部分

创建一个新的部分操作，即QAction::isSeparator() 返回true但同时具有文本提示的操作，并将新操作添加到此菜单的操作列表中。它返回新创建的操作。

QMenu拥有返回的QAction的所有权。

  1. QAction * addSection(const QString &text)
  2. QAction * addSection(const QIcon &icon, const QString &text)
  3. QAction * insertSection(QAction *before, const QString &text)
  4. QAction * insertSection(QAction *before, const QIcon &icon, const QString &text)

增加分割线

  1. QAction * addSeparator()
  2. QAction * insertSeparator(QAction *before)

分离式菜单

  1. void hideTearOffMenu()
  2. bool isTearOffMenuVisible() const
  3. void showTearOffMenu()
  4. void showTearOffMenu(const QPoint &pos)

清空

  1. void clear()
  2. bool isEmpty() const

显示

  1. QAction * exec() 同步显示

  2. QAction * exec(const QPoint &p, QAction *action = nullptr)

    exec(QCursor::pos()); 当前鼠标位置

    exec( somewidget.mapToGlobal( QPoint(0,0) ) ); 与小部件对齐

    exec(e->globalPos()); 对QMouseEvent* e的反应

  3. void popup(const QPoint &p, QAction *atAction = nullptr) 异步显示

macOS相关

  1. void setAsDockMenu() 通过单击应用程序停靠图标选项，将此菜单设置为可用的停靠菜单。仅在macOS上可用。
  2. NSMenu * toNSMenu() 返回此菜单的本机NSMenu。仅在macOS上可用

重写的公共函数

  1. virtual QSize sizeHint() const override

信号

  1. void aboutToHide() 将要隐藏

  2. void aboutToShow() 将要显示

  3. void hovered(QAction *action) 此信号在高亮显示菜单操作时发出
    操作是导致发出信号的操作。这通常用于更新状态信息。

  4. void triggered(QAction *action) 此信号在触发此菜单中的操作时发出
    动作是导致发出信号的动作。

    通常，您会将每个菜单操作的triggered() 信号连接到它自己的自定义槽，但有时您会希望将多个操作连接到单个槽，例如，当您有一组密切相关的操作时，例如“left justify”、“center”、“right justify”。

    注意：此信号是为层次结构中的主父菜单发出的。因此，只有父菜单需要连接到插槽；子菜单不需要连接。

静态的公共函数

  1. QAction * exec(QList<QAction *> actions, const QPoint &pos, QAction *at = nullptr, QWidget *parent = nullptr)

受保护的函数

  1. int columnCount() const
  2. void initStyleOption(QStyleOptionMenuItem *option, const QAction *action) const

重写的受保护的函数

  1. virtual void actionEvent(QActionEvent *e) override
  2. virtual void changeEvent(QEvent *e) override
  3. virtual void enterEvent(QEvent *) override
  4. virtual bool event(QEvent *e) override
  5. virtual bool focusNextPrevChild(bool next) override
  6. virtual void hideEvent(QHideEvent *) override
  7. virtual void keyPressEvent(QKeyEvent *e) override
  8. virtual void leaveEvent(QEvent *) override
  9. virtual void mouseMoveEvent(QMouseEvent *e) override
  10. virtual void mousePressEvent(QMouseEvent *e) override
  11. virtual void mouseReleaseEvent(QMouseEvent *e) override
  12. virtual void paintEvent(QPaintEvent *e) override
  13. virtual void timerEvent(QTimerEvent *e) override
  14. virtual void wheelEvent(QWheelEvent *e) override

相关代码

#include <QtWidgets>
int main(int argc, char *argv[])
{
    QApplication::setStyle (QStyleFactory::create ("fusion")); //windowsvista fusion

    QApplication app(argc,argv);
    app.setApplicationName ("QMenu");

    QMainWindow w0;

    QMenu *menuFile = new QMenu("File",&w0);
    menuFile->addAction ("打开");
    menuFile->addSeparator ();
    menuFile->addSection ("保存操作");
    menuFile->addAction ("保存");
    menuFile->addAction ("另存为...");

    menuFile->setToolTipsVisible (true);

    w0.menuBar ()->addMenu (menuFile);

    QLabel *label = new QLabel(&w0);
    label->setMargin (10);
    label->setStyleSheet ("color:blue");
    label->setText (
                "\n\n\nQMenu *menuFile = new QMenu(\"File\",&w0); \n"
                "menuFile->addAction (\"打开\")->setToolTip (\"Open\");\n"
                "menuFile->addAction (\"保存\")->setToolTip (\"Save\");\n"
                "menuFile->addSeparator ();\n\n"
                "menuFile->setToolTipsVisible (true);");

    w0.setCentralWidget (label);


    w0.show ();

    app.exec();
    return 0;
}

参考

  • 应用程序示例 Application Example
  • 菜单示例 Menus Example
hitzsf
关注
专栏目录
Qt常用基础控件总结—菜单控件(QMenu类)
qq_37464701的博客
07-09 457
QMenu 是Qt库中用于创建弹出式菜单的类，它通常出现在应用程序的顶部菜单栏、按钮的右键菜单或自定义上下文菜单中。QMenu 类提供了一系列方法来添加菜单项、子菜单以及关联槽函数，以便在用户选择菜单项时执行相应的动作。使用 exec(QPoint globalPos) 弹出菜单并等待用户选择一个项，然后返回被选中项的 QAction 对象指针。通过关联槽函数到 triggered(QAction *) 信号，可以在用户选择菜单项时执行相应操作。//在菜单中添加一个分隔线，用于区分不同的菜单项组。
【解决问题】from PyQt5 import QtCore, QtGui, QtWidgets ImportError: DLL load failed: 找不到指定的程序。
热门推荐
Leonadoice的博客
04-08 3万+
我的环境是搭建好很久很久了，前几天运行项目还没有问题，但是今天一运行就报错： 查了网上的一些资料以后，说是 python3.dll丢失导致的，但是我检查了我的安装路径里面是存在的，于是打算重装一下pyqt相关的组件。 正准备按照这个博主的步骤安装的时候，又出现： 根据资料，又把anaconda 重装了下： conda install anaconda ...
Qt扫盲-QMenu理论总结
洪源兄
01-12 4777
QMenu其实就是菜单控件，菜单控件本质上就是一个选择项目。它可以是菜单栏中的下拉菜单，也可以是独立的上下文菜单。当用户单击相应的位置或按下指定的快捷键时，下拉菜单由菜单栏显示。使用QMenuBar::addMenu()向菜单栏插入一个菜单。当然菜单同样也是可以嵌套使用，也就是按钮里面嵌套按钮的。样子就像这种单层菜单还有嵌套的菜单。
经典wpf菜单MenuItem样式1
05-06
wpf菜单MenuItem样式经典源代码,绝对经典，颜色根据自己需要修改
底部菜单_AXURE原型——移动端标签、菜单原型集合
weixin_42515842的博客
12-30 451
hello，今天和大家分享移动端菜单合集，里面包括了常用菜单页面、侧栏菜单、弹窗菜单、锚点菜单、顶部标签菜单、和底部标签菜单。然后除了底部和锚点菜单外，其余菜单都是用中继器制作的，交互效果啥的都设置好了，大家只需要填写中继器表格即可使用，非常方便。该原型axure8、9通用原型预览及下载地址：https://www.pmdaniu.com/storages/120856/4f94907795d7b...
AXURE原型——移动端标签、菜单原型集合
mushe93的博客
07-14 856
原型预览及下载地址：https://www.pmdaniu.com/storages/120856/4f94907795d7b90ca268c8cedc748a2e-69620/start.html?_d=Tue%20Jul%2014%202020%2014:23:52%20GMT+0800%20(%E4%B8%AD%E5%9B%BD%E6%A0%87%E5%87%86%E6%97%B6%E9%97%B4)#id=vwjg69&p=%E5%B8%B8%E7%94%A8%E8%8F%9C%E5%8D%
WPF 配置菜单栏（Menu）
韬光养晦
03-03 2544
WPF 配置菜单栏（Menu） 代码段： <Window x:Class="WpfApp2.MainWindow" xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" ...
WPF实现多级菜单(菜单多按钮)
12-04
1、利用WPF实现垂直分布的多级菜单 2、按钮模板重定义 3、动画效果 4、重定义后的按钮响应多个command，实现单个按钮多种功能 5、command的定义和使用 6、子类、父类的应用 7、我的环境是XP和vs2010
yii2-widgets：扩展Yii2和Bootstrap 4的小部件类
01-30
扩展Yii2和Bootstrap 4的小部件类 视图上所有小部件类的扩展类 包含 ButtonAjax用于制作显示模式的Ajax按钮 LinkAjax用于制作显示模式的Ajax链接 安装 安装此扩展的首选方法是通过 。 无论运行 ...
Flutter-Basic-Widgets:Flutter基本小部件
05-02
Flutter基本小部件 Very basic flutter widgets. 如何添加自己的示例？ 1. Import your example.dart file in main.dart 2. You must have routeName static final String variable in your example file. static ...
qt-material-widgets：基于Qt小部件的Material Design规范实现
02-04
qt-material-widgets：基于Qt小部件的Material Design规范实现
wpfMenu样式
11-18
项目需要，重新写了一下menu样式。自定义了控件模板，用图片替换了背景色，效果很好看。
WPF自定义多级菜单功能
08-06
采用wpf自定义控件，自定义布局，实现后台动态添加多级菜单功能，菜单构成是一级菜单上层小图片，下层菜单名。二级菜单是左侧小图片，右侧是菜单名称。一级和二级菜单有默认背景图片和选中后的图片。点击一级菜单动态加载二级菜单。菜单有钉子动画功能但此功能有些问题不需要钉子功能可以不用此功能。wpf功底好点的可以自己研究钉子功能。
精美WPF左侧菜单栏
07-24
精美WPF左侧菜单栏，实现了点击菜单自动展开子菜单，右侧显示菜单详细列表！
wpf菜单MenuItem样式经典
12-02
wpf菜单MenuItem样式经典源代码,绝对经典，
WPF漂亮的导航菜单
11-05
WPF开发的漂亮酷炫的导航菜单实例程序，导航菜单实例注释讲解十分详细。
JS_HTML_Widgets：轻松创建任意复杂度的小部件对象
02-06
JS_HTML_Widgets 轻松创建任意复杂度的小部件对象 列昂尼德·季托夫（Leonid Titov），2019-09-23 请下载并在浏览器中打开Widget_v3.md.html，然后阅读。 或者，转到此的Githab页面，然后从此处单击指向的链接。 ...
WPF创建漂亮的菜单栏
xieehu的博客
02-21 1846
如何用WPF做菜单，如何给菜单添加图标
WPF —— Expander折叠栏 、菜单标签 menu
最新发布
一个新人博客，愿多多支持。
03-25 2910
Expander控件有一个箭头按钮。单击箭头时，Expander中的子元素将显示或隐藏。箭头“展开”控件，使其子控件可见。Menu 表示一个 Windows 菜单控件，该控件可用于按层次组织与命令和事件处理程序关联的元素。该 Menu 控件提供一个项列表，用于指定应用程序的命令或选项。通常，单击菜单上的项会打开子菜单或导致应用程序执行命令。
AttributeError: 'QMenu' object has no attribute 'clicked'
09-21
from PyQt5.QtWidgets import QApplication, QMainWindow, QMenu, QAction class MyWindow(QMainWindow): def __init__(self): super().__init__() menu = QMenu(self) action = QAction("Click me", self) ...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值