ZetCode

Qt4 中的菜单和工具栏

最后修改于 2023 年 10 月 18 日

在本 Qt4 C++ 编程教程中,我们将讨论 Qt4 应用程序中的菜单和工具栏。

菜单栏是 GUI 应用程序的常见部分。它是一组位于称为菜单的各个位置的命令。菜单将我们可以在应用程序中使用的命令分组。工具栏提供对最常用命令的快速访问。

简单菜单

第一个示例显示一个简单的菜单。

simplemenu.h
#pragma once

#include <QMainWindow>
#include <QApplication>

class SimpleMenu : public QMainWindow {

  public:
    SimpleMenu(QWidget *parent = 0);
};

这是我们代码示例的头文件。

simplemenu.cpp
#include "simplemenu.h"
#include <QMenu>
#include <QMenuBar>

SimpleMenu::SimpleMenu(QWidget *parent)
    : QMainWindow(parent) {
    
  QAction *quit = new QAction("&Quit", this);

  QMenu *file;
  file = menuBar()->addMenu("&File");
  file->addAction(quit);

  connect(quit, SIGNAL(triggered()), qApp, SLOT(quit()));
}

我们有一个菜单栏、一个菜单和一个动作。为了使用菜单,我们必须从 QMainWindow 窗口部件继承。

QAction *quit = new QAction("&Quit", this);

这行代码创建了一个 QAction。每个 QMenu 都有一个或多个动作对象。

QMenu *file;
file = menuBar()->addMenu("&File");

我们创建一个 QMenu 对象。

file->addAction(quit);

我们使用 addAction 方法将一个动作放入菜单中。

connect(quit, SIGNAL(triggered()), qApp, SLOT(quit()));

当我们从菜单中选择此选项时,应用程序将退出。

main.cpp
#include "simplemenu.h"

int main(int argc, char *argv[]) {

  QApplication app(argc, argv);  
    
  SimpleMenu window;

  window.resize(250, 150);
  window.setWindowTitle("Simple menu");
  window.show();

  return app.exec();
}

主文件。

Simple menu
图:简单菜单

图标、快捷方式和分隔符

在下面的示例中,我们进一步增强了之前的应用程序。我们向菜单添加图标,使用快捷方式和分隔符。

anothermenu.h
#pragma once

#include <QMainWindow>
#include <QApplication>

class AnotherMenu : public QMainWindow {
    
  public:
    AnotherMenu(QWidget *parent = 0);
};

该示例的头文件。

anothermenu.cpp
#include "anothermenu.h"
#include <QMenu>
#include <QMenuBar>

AnotherMenu::AnotherMenu(QWidget *parent)
    : QMainWindow(parent) {
          
  QPixmap newpix("new.png");
  QPixmap openpix("open.png");
  QPixmap quitpix("quit.png");

  QAction *newa = new QAction(newpix, "&New", this);
  QAction *open = new QAction(openpix, "&Open", this);
  QAction *quit = new QAction(quitpix, "&Quit", this);
  quit->setShortcut(tr("CTRL+Q"));

  QMenu *file;
  file = menuBar()->addMenu("&File");
  file->addAction(newa);
  file->addAction(open);
  file->addSeparator();
  file->addAction(quit);
  
  qApp->setAttribute(Qt::AA_DontShowIconsInMenus, false);

  connect(quit, SIGNAL(triggered()), qApp, SLOT(quit()));
}

在我们的示例中,我们有一个菜单,其中包含三个动作。如果我们选择它,只有退出操作才会真正做一些事情。我们还创建了一个分隔符和 CTRL+Q 快捷方式,用于终止应用程序。

QPixmap newpix("new.png");
QPixmap openpix("open.png");
QPixmap quitpix("quit.png");

这些是我们用于菜单的图像。请注意,某些桌面环境可能不会在菜单中显示图像。

QAction *newa = new QAction(newpix, "&New", this);
QAction *open = new QAction(openpix, "&Open", this);
QAction *quit = new QAction(quitpix, "&Quit", this);

在本代码中,我们使用带有 pixmap 作为第一个参数的 QAction 构造函数。

quit->setShortcut(tr("CTRL+Q"));

在这里,我们创建一个键盘快捷方式。通过按下此快捷方式,我们将运行退出操作,该操作将退出应用程序。

file->addSeparator();

我们创建一个分隔符。分隔符是一条水平线,使我们能够将菜单操作分组到一些逻辑组中。

qApp->setAttribute(Qt::AA_DontShowIconsInMenus, false);

在某些环境中,默认情况下不显示菜单图标。在这种情况下,我们可以禁用 Qt::AA_DontShowIconsInMenus 属性。

main.cpp
#include "anothermenu.h"

int main(int argc, char *argv[]) {

  QApplication app(argc, argv);  
    
  AnotherMenu window;

  window.resize(350, 200);
  window.move(300, 300);  
  window.setWindowTitle("Another menu");
  window.show();

  return app.exec();
}

这是主文件。

Another menu example
图:另一个菜单示例

可勾选的菜单

在下一个示例中,我们创建一个可勾选的菜单。这将是一个带有复选框的动作。该选项切换状态栏的可见性。

checkable.h
#pragma once

#include <QMainWindow>
#include <QApplication>

class Checkable : public QMainWindow {
    
  Q_OBJECT  

  public:
    Checkable(QWidget *parent = 0);
 
  private slots:
    void toggleStatusbar();

  private:
    QAction *viewst;
};

该示例的头文件。

checkable.cpp
#include "checkable.h"
#include <QMenu>
#include <QMenuBar>
#include <QStatusBar>

Checkable::Checkable(QWidget *parent)
    : QMainWindow(parent) {

  viewst = new QAction("&View statusbar", this);
  viewst->setCheckable(true);
  viewst->setChecked(true);

  QMenu *file;
  file = menuBar()->addMenu("&File");
  file->addAction(viewst);

  statusBar();

  connect(viewst, SIGNAL(triggered()), this, SLOT(toggleStatusbar()));
}

void Checkable::toggleStatusbar() {
    
  if (viewst->isChecked()) {
      
      statusBar()->show();
  } else {
      
      statusBar()->hide();
  }
}

可勾选的菜单项切换状态栏的可见性。

viewst = new QAction("&View statusbar", this);
viewst->setCheckable(true);
viewst->setChecked(true);

我们创建一个动作,并使用 setCheckable 方法使其可勾选。setChecked 方法使其被选中。

if (viewst->isChecked()) {
    
    statusBar()->show();
} else {
    
    statusBar()->hide();
}

toggleStatusbar 方法中,我们确定菜单项是否被选中,并相应地隐藏或显示状态栏。

main.cpp
#include "checkable.h"

int main(int argc, char *argv[]) {
    
  QApplication app(argc, argv);  
    
  Checkable window;

  window.resize(250, 150);
  window.setWindowTitle("Checkable menu");
  window.show();

  return app.exec();
}

这是主文件。

Checkable menu
图:可勾选的菜单

QToolBar

QToolBar 类提供一个可移动的面板,其中包含一组控件,这些控件提供对应用程序操作的快速访问。

toolbar.h
#pragma once

#include <QMainWindow>
#include <QApplication>

class Toolbar : public QMainWindow {
    
  Q_OBJECT  

  public:
    Toolbar(QWidget *parent = 0);
};

该示例的头文件。

toolbar.cpp
#include "toolbar.h"
#include <QToolBar>
#include <QIcon>
#include <QAction>

Toolbar::Toolbar(QWidget *parent)
    : QMainWindow(parent) {
    
  QPixmap newpix("new.png");
  QPixmap openpix("open.png");
  QPixmap quitpix("quit.png");
  
  QToolBar *toolbar = addToolBar("main toolbar");
  toolbar->addAction(QIcon(newpix), "New File");
  toolbar->addAction(QIcon(openpix), "Open File");
  toolbar->addSeparator();
  QAction *quit = toolbar->addAction(QIcon(quitpix), 
      "Quit Application");
  
  connect(quit, SIGNAL(triggered()), qApp, SLOT(quit()));
}

要创建一个工具栏,我们从 QMainWindow 窗口部件继承。

QToolBar *toolbar = addToolBar("main toolbar");

addToolBar 方法创建一个工具栏并返回一个指向它的指针。

toolbar->addAction(QIcon(newpix), "New File");
toolbar->addAction(QIcon(openpix), "Open File");
toolbar->addSeparator();

在这里,我们将两个动作和一个分隔符添加到工具栏中。

main.cpp
#include "toolbar.h"

int main(int argc, char *argv[]) {
    
  QApplication app(argc, argv);  
    
  Toolbar window;

  window.resize(300, 200);
  window.setWindowTitle("QToolBar");
  window.show();

  return app.exec();
}

这是主文件。

QToolBar
图:QToolBar

应用程序框架

在本 C++ Qt4 教程的最后,我们创建了一个应用程序框架。该示例主要基于 QMainWindow 窗口部件。

skeleton.h
#pragma once

#include <QMainWindow>
#include <QApplication>

class Skeleton : public QMainWindow {
    
  Q_OBJECT  

  public:
    Skeleton(QWidget *parent = 0);
};

该示例的头文件。

skeleton.cpp
#include "skeleton.h"
#include <QToolBar>
#include <QIcon>
#include <QAction>
#include <QMenu>
#include <QMenuBar>
#include <QStatusBar>
#include <QTextEdit>

Skeleton::Skeleton(QWidget *parent)
    : QMainWindow(parent) {
        
  QPixmap newpix("new.png");
  QPixmap openpix("open.png");
  QPixmap quitpix("quit.png");

  QAction *quit = new QAction("&Quit", this);

  QMenu *file;
  file = menuBar()->addMenu("&File");
  file->addAction(quit);

  connect(quit, SIGNAL(triggered()), qApp, SLOT(quit()));
  
  QToolBar *toolbar = addToolBar("main toolbar");
  toolbar->addAction(QIcon(newpix), "New File");
  toolbar->addAction(QIcon(openpix), "Open File");
  toolbar->addSeparator();
  
  QAction *quit2 = toolbar->addAction(QIcon(quitpix), 
      "Quit Application");
  connect(quit2, SIGNAL(triggered()), qApp, SLOT(quit()));

  QTextEdit *edit = new QTextEdit(this);  

  setCentralWidget(edit);

  statusBar()->showMessage("Ready");
}

在这里,我们创建一个菜单、一个工具栏和一个状态栏。

QTextEdit *edit = new QTextEdit(this);  

setCentralWidget(edit);

我们创建一个 QTextEdit 窗口部件,并将其放置在 QMainWindow 窗口部件的中心部分。

main.cpp
#include "skeleton.h"

int main(int argc, char *argv[]) {
    
  QApplication app(argc, argv);  
    
  Skeleton window;

  window.resize(350, 250);
  window.setWindowTitle("Application skeleton");
  window.show();

  return app.exec();
}

这是主文件。

Application skeleton
图:应用程序框架

在本 Qt4 教程中,我们已经介绍了菜单和工具栏。