QMenuBar Class

menubar->addMenu(fileMenu);

    fileMenu = menuBar()->addMenu(tr("&File"));
    fileMenu->addAction(newAct);

QMenuBar *menuBar = new QMenuBar(nullptr);

成员函数文档

[explicit] QMenuBar::QMenuBar(QWidget *parent = nullptr)

使用父对象parent 构建一个菜单栏。

[virtual noexcept] QMenuBar::~QMenuBar()

隐藏菜单栏。

QAction *QMenuBar::actionAt(const QPoint &pt) const

返回pt 上的QAction 。如果pt 上没有相应操作，或者该位置包含分隔符，则返回nullptr 。

另请参阅 QWidget::addAction() 和addSeparator()。

[override virtual protected] void QMenuBar::actionEvent(QActionEvent *e)

重写了：QWidget::actionEvent(QActionEvent *event)。

QRect QMenuBar::actionGeometry(QAction *act) const

返回动作act 的几何体，类型为QRect 。

另请参阅 actionAt()。

QAction *QMenuBar::activeAction() const

返回当前被高亮显示的QAction （如有），否则返回nullptr 。

另请参阅 setActiveAction()。

QAction *QMenuBar::addMenu(QMenu *menu)

将menu 添加到菜单栏中。返回该菜单的menuAction()。菜单栏不会获取该菜单的所有权。

另请参阅 QWidget::addAction() 和QMenu::menuAction()。

QMenu *QMenuBar::addMenu(const QString &title)

将一个带有title 的新QMenu 添加到菜单栏中。菜单栏将接管该菜单。返回新菜单。

另请参阅 QWidget::addAction() 和QMenu::menuAction()。

QMenu *QMenuBar::addMenu(const QIcon &icon, const QString &title)

将一个包含icon 和title 的新QMenu 添加到菜单栏中。菜单栏将接管该菜单的所有权。返回新的菜单。

另请参阅 QWidget::addAction() 和QMenu::menuAction()。

QAction *QMenuBar::addSeparator()

在菜单后添加一个分隔符。

[override virtual protected] void QMenuBar::changeEvent(QEvent *e)

重写了：QWidget::changeEvent(QEvent *event)。

void QMenuBar::clear()

从菜单栏中移除所有操作。

另请参阅 removeAction()。

QWidget *QMenuBar::cornerWidget(Qt::Corner corner = Qt::TopRightCorner) const

根据 `corner` 的值，返回位于第一个菜单项左侧或最后一个菜单项右侧的小部件。

另请参阅 setCornerWidget()。

[override virtual protected] bool QMenuBar::event(QEvent *e)

重写了：QWidget::event(QEvent *event)。

[override virtual protected] bool QMenuBar::eventFilter(QObject *object, QEvent *event)

重写了：QObject::eventFilter(QObject *watched, QEvent *event)。

[override virtual protected] void QMenuBar::focusInEvent(QFocusEvent *)

重写了：QWidget::focusInEvent(QFocusEvent *event)。

[override virtual protected] void QMenuBar::focusOutEvent(QFocusEvent *)

重写了：QWidget::focusOutEvent(QFocusEvent *event)。

[override virtual] int QMenuBar::heightForWidth(int) const

重新实现了：QWidget::heightForWidth(int w) const。

[signal] void QMenuBar::hovered(QAction *action)

当菜单操作被高亮显示时，会发出此信号；action 是触发该事件的操作。

通常，这用于更新状态信息。

另请参阅 triggered() 和QAction::hovered()。

[virtual protected] void QMenuBar::initStyleOption(QStyleOptionMenuItem *option, const QAction *action) const

使用菜单栏中的值以及action 中的信息初始化option 。当子类需要QStyleOptionMenuItem 时，但又不想自己填写所有信息，此方法非常有用。

另请参阅 QStyleOption::initFrom() 和QMenu::initStyleOption()。

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

此便捷函数会在操作 `before ` 之前插入 `menu `，并返回菜单 `menuAction()`。

另请参阅 QWidget::insertAction() 和addMenu()。

QAction *QMenuBar::insertSeparator(QAction *before)

此便捷函数会创建一个新的分隔符操作，即一个QAction::isSeparator()返回true的操作。该函数将新创建的操作插入到此菜单栏的操作列表中，位置在操作before 之前，并返回该操作。

另请参阅 QWidget::insertAction() 和addSeparator()。

[override virtual protected] void QMenuBar::keyPressEvent(QKeyEvent *e)

重写了：QWidget::keyPressEvent(QKeyEvent *event)。

[override virtual protected] void QMenuBar::leaveEvent(QEvent *)

重写了：QWidget::leaveEvent(QEvent *event)。

[override virtual] QSize QMenuBar::minimumSizeHint() const

重新实现了属性QWidget::minimumSizeHint 的访问函数。

[override virtual protected] void QMenuBar::mouseMoveEvent(QMouseEvent *e)

重写了：QWidget::mouseMoveEvent(QMouseEvent *event)。

[override virtual protected] void QMenuBar::mousePressEvent(QMouseEvent *e)

重写：QWidget::mousePressEvent(QMouseEvent *event)。

[override virtual protected] void QMenuBar::mouseReleaseEvent(QMouseEvent *e)

重写了：QWidget::mouseReleaseEvent(QMouseEvent *event)。

[override virtual protected] void QMenuBar::paintEvent(QPaintEvent *e)

重写了：QWidget::paintEvent(QPaintEvent *event)。

[override virtual protected] void QMenuBar::resizeEvent(QResizeEvent *)

重写了：QWidget::resizeEvent(QResizeEvent *event)。

void QMenuBar::setActiveAction(QAction *act)

将当前选中的操作设置为“act ”。

另请参阅 activeAction()。

void QMenuBar::setCornerWidget(QWidget *widget, Qt::Corner corner = Qt::TopRightCorner)

这会将给定的widget 设置为直接显示在第一个菜单项的左侧，或最后一个菜单项的右侧，具体取决于corner 。

菜单栏将接管widget ，将其重新归入菜单栏。但是，如果corner 中已经包含一个控件，则该原有控件将不再被管理，但仍作为菜单栏的可见子控件存在。

另请参阅 cornerWidget()。

[override virtual slot] void QMenuBar::setVisible(bool visible)

重新实现了属性QWidget::visible 的访问函数。

[override virtual] QSize QMenuBar::sizeHint() const

重新实现了属性QWidget::sizeHint 的访问函数。

[override virtual protected] void QMenuBar::timerEvent(QTimerEvent *e)

重写了：QObject::timerEvent(QTimerEvent *event)。

NSMenu *QMenuBar::toNSMenu()

返回此菜单栏的原生 NSMenu。仅在 macOS 上可用。

[signal] void QMenuBar::triggered(QAction *action)

当通过鼠标点击触发了属于此菜单栏的菜单中的某个操作时，会发出此信号；action 即为触发该信号的操作。

通常，您会使用 `QAction::triggered()` 将每个菜单操作连接到一个槽，但有时您可能希望将多个项目连接到一个槽（最常见的情况是用户从数组中进行选择）。在这种情况下，此信号非常有用。

另请参阅 hovered() 和QAction::triggered()。