QT creator使用（五）：应用程序主窗口QMainWindow

最新推荐文章于 2025-02-26 09:52:10 发布

APS2023

最新推荐文章于 2025-02-26 09:52:10 发布

阅读量4.8k

点赞数 5

分类专栏： QT 文章标签： c++ qt 开发语言

本文链接：https://blog.csdn.net/qq_41694024/article/details/125659978

版权

QT 专栏收录该内容

4 篇文章

订阅专栏

5.0 本章简介

        这一章开始接触应用程序主窗口的相关内容。对于日常见到的应用程序而言，许多都是基于主窗口的，主窗口包含了菜单栏、工具栏、状态栏和中心区域等。

        这一章会详细介绍主窗口的每一个部分，还会涉及资源管理、富文本处理、拖放操作和文档打印等相关内容。
        Qt中提供了以QMain Window类为核心的主窗口框架，它包含了众多相关的类，它们的继承关系如下图所示，本章中会讲解到图中每一个类的基本应用。

5.1 主窗口框架

        主窗口为建立应用程序用户界面提供了一个框架，Qt提供了QMainWindow和其他一些相关的类共同完成主窗口的管理。QMainWindow类拥有自己的布局，包含以下组件：
①菜单栏(QMenuBar)：

        菜单栏包含了一个下拉菜单项的列表，这些菜单项由QAction动作类实现。菜单栏位于主窗口的顶部，一个主窗口只能有一个菜单栏。
②工具栏(QToolBar)：

        工具栏一般用于显示一些常用的菜单项目，也可以插入其他窗口部件，并且是可以移动的。一个主窗口可以拥有多个工具栏。
③中心部件(Central Widget)：

        在主窗口的中心区域可以放入一个窗口部件作为中心部件，是应用程序的主要功能实现区域。一个主窗口只能拥有一个中心部件。
④Dock部件(QDock Widget)：

        Dock部件常被称为停靠窗口，因为可以停靠在中心部件的四周，用来放置一些部件来实现一些功能，就像个工具箱一样。一个主窗口可以拥有多个Dock部件。
⑤状态栏(QStatusBar)：

        状态栏用于显示程序的一些状态信息，在主窗口的最底部。一个主窗口只能拥有一个状态栏。
        本节知识可以在帮助索引中通过Application Main Window关键字查看，列出了所有与创建主窗口应用程序相关的类，也可以查看Main Window示例程序。

5.1.1 Qt资源系统、菜单栏和工具栏

        下面先来看一个例子。新建Qt Widgets应用，项目名称mymainwindow，类名默认为MainWindow，基类默认为QMainWindow，不改动。建立好项目后，在文件列表中双击mainwindow.ui文件进入设计模式，这时在设计区域出现的便是主窗口界面。

        下面来添加菜单，双击左上角的“在这里输入”，修改为“文件(&F)”，这里要使用英文半角的括号，“&F”被称为加速键，表明程序运行时可以按下Alt＋F键来激活该菜单。

        修改完成后按下回车键，并在弹出的下拉菜单中将第一项改为“新建文件(&N)”，并按下回车键(由于版本原因，如果这里无法直接输入中文，则可以通过复制粘贴完成)，效果如下图所示：

         这时可以看到，下面的Action编辑器中已经有了“新建文件”动作，如下图所示。

        选中该动作并将其拖入菜单栏下面的工具栏中，如下图所示。

        在设计器中创建主窗口也可以在帮助索引中通过Creating Main Windows in Qt Designer关键字查看。

          运行程序，按下Alt＋F键就可以打开文件菜单，按下N键就可以激活新建文件菜单。需要说明的是，必须是文件菜单在激活状态时按下N键才有效，这也就是加速键与快捷键的不同之处。因为一般的菜单都有一个对应的图标，下面就来为菜单添加图标。

1.使用资源

        3.3.1小节讲解标签部件时使用了图片，不过那里的图片是放在可执行程序外部的，如果图片位置发生变化，程序将无法显示图片。这里将使用Qt的资源系统来存储图片，就可以嵌入到可执行文件之中了。步骤如下：
第一步，添加Qt资源文件。往项目中添加新文件，选择Qt分类中的Qt Resource File，文件名称改为myimages，其他选项默认即可。

第二步，添加资源。建立好资源文件后会默认进入资源管理界面，打开 myimages.qrc文件。现在先到项目文件夹mymainwindow中新建一个名为image的文件夹，并在其中放入两张图标图片，比如放入了一个1.jpg和一个2.jpg图片。(注意：Qt资源系统要求资源文件必须放在与src文件同级或子级目录下，如果放在其他地方，则添加资源时会提示将文件复制到有效的位置。)

        然后回到Qt Creator中，在资源管理界面单击“添加”按钮，选择“添加前缀”，然后将属性栏中的前缀改为“/image”，再单击“添加”按钮选择“添加文件”，在弹出的对话框中进入到前面新建的images文件夹中，选中那两张图片，单击“打开”即可。这时myimages.qrc文件中就出现了添加的图片列表。最后，按下Ctrl+S快捷键保存对文件的修改(注意：这一点很重要，如果没有保存，下面使用图片时将看不到图片)。

第三步，使用图片。先使用Ctrl+Tab快捷键转到mainwindow.ui文件，回到设计模式(如果先前没有打开过mainwindow. ui文件，那么该快捷键无法切换，需要直接双击该文件进行打开)。在Action编辑器中双击“新建文件”动作，这时会弹出编辑动作对话框。

        将对象名称改为action_New，工具提示ToolTip改为“新建文件”，然后按下“图标”后面的按钮进入选择资源界面。第一次进入该界面时，如果没有显示可用的资源，则可以单击左上角的重新加载绿色箭头图标，这时图片资源就显示出来了。这里选择1.jpg图片并单击OK按钮。

        最后在快捷键 Shortcut后面的输入栏上单击并按下Ctrl+N组合键，就可以将它设为这个动作的快捷键了。这样就为动作添加了图标和快捷键，如下图所示：

        单击OK按钮关闭对话框。因为设置了工具提示，所以运行程序时可以将鼠标停在工具栏的一个动作上来显示提示信息。（把新建文件的按钮变成了图标....还带提示）

         可以在帮助索引中查看The Qt Resource System关键字，这里介绍了Qt资源系统的相关内容。前面在使用资源时添加的qrc资源文件其实是一个 XML格式的文本文件，现在进入编辑模式，在 myimages.qrc文件上右击，在弹出的级联菜单中选择“Open With→普通文本编辑器”，这时就会看到myimages.qrc的内容如下：
<RCC>
    <qresource prefix="/image">
        <file>image/1.jpg</file>
        <file>image/2.jpg</file>
    </qresource>
</RCC>
这里指明了文件类型为RCC，表明是Qt资源文件。然后是资源前缀，其下面罗列了添加的图片路径。如果编写代码时要使用1.jpg图片，那么就可以将其路径指定为“:/image/images/1.png（相对路径）”，这样就表明在使用资源文件中的图片；其中添加的前缀“/image”只是用来表明这是图片资源，可以改为别的名字，也可以为空。前面在Resource Editor中进行图片添加操作，这种方式比较方便明了，也可以按照这里的格式使用手写代码来添加图片。
往项目中添加了一个资源文件时，会自动往工程文件 mymainwindow.pro中添加代码：
RESOURCES += \
myiamges.qrc
这表明项目中使用了资源文件 myimages.qrc。在前面的过程中这是自动生成的，但是如果是自己添加的已有的资源文件，要想在项目中使用，那么就要手动添加这行代码。其实资源可以是任意类型的，不只是图片文件。编译时会对加入的资源自动压缩，这也就是为什么有时生成的release版本可执行文件比添加进去的资源还要小的原因。

如何将别人的资源文件变成自己的：只需要添加上述代码即可：
RESOURCES += \
myiamges.qrc

2.编写代码方式添加菜单

前面在设计器中添加了文件菜单，然后添加了新建文件子菜单，其实这些都可以使用代码来实现。下面使用代码来添加一个菜单，在mainwindow.cpp 文件的MainWindow类构造函数中添加代码：
MainWindow::MainWindow(QWidget *parent)
    : QMainWindow(parent)
    , ui(new Ui::MainWindow)
{
    ui->setupUi(this);
    //创建菜单对象并加入新菜单
    QMenu * editMenu = ui -> menubar -> addMenu(tr("编辑(&E)"));
    
    //添加工具栏：选择图片代替和文本提示、快捷键；菜单栏新建一个条目
    QAction * action_Open = editMenu -> addAction(QIcon(":/image/image/2.jpg"),tr("打开文件(&O)"));
    action_Open -> setShortcut(QKeySequence("Ctrl + O"));

    //添加工具栏
    ui -> toolBar -> addAction(action_Open);
}
这里使用ui→menubar 来获取QMain Window的菜单栏，使用ui→toolbar来获取QMain Window的工具栏，然后分别使用相应的函数添加菜单和动作。

就像前面提到过的，在菜单中的各种菜单项都是一个QAction类对象，这个后面还会讲到现在运行程序就可以看到已经添加了新的菜单了。

3.菜单栏

         QMenuBar类提供了一个水平的菜单栏，在QMain Window 中可以直接获取默认的菜单栏，向其中添加QMenu类型的菜单对象，然后向弹出的菜单中添加QAction类型的动作对象作为菜单项。

         QMenu中还提供了间隔器，可以在设计器中向添加菜单那样直接添加间隔器，或者在代码中使用addSeparator()函数来添加，它是一条水平线，可以将菜单进行分组，使得布局很整齐。

        应用程序中很多普通的命令都是通过菜单来实现的，而我们也希望能将这些菜单命令放到工具栏中以方便使用。QAction就是这样一种命令动作，可以同时放在菜单和工具栏中。一个QAction动作包含了图标、菜单显示文本、快捷键、状态栏显示文本、“What's This?”显示文本和工具提示文本。这些都可以在构建QAction类对象时在构造函数中指定。另外，还可以设置QAction的checkable属性，如果指定这个动作的checkable为 true，那么选中这个菜单时就会在它的前面显示“√”之类的表示选中状态的符号；如果该菜单有图标，就会用线框将图标围住，用来表示该动作被选中了。

        下面再介绍一个动作组QActionGroup类。它可以包含一组动作QAction，可以设置这组动作中是否只能有一个动作处于选中状态，这对于互斥型动作很有用。在前面程序的Main Window类构造函数中继续添加如下代码：
MainWindow::MainWindow(QWidget *parent)
    : QMainWindow(parent)
    , ui(new Ui::MainWindow)
{
    ui->setupUi(this);
    QMenu * editMenu = ui -> menubar -> addMenu(tr("编辑(&E)"));
    QAction * action_Open = editMenu -> addAction(QIcon(":/image/image/2.jpg"),tr("打开文件(&O)"));
    action_Open -> setShortcut(QKeySequence("Ctrl + O"));
    ui -> toolBar -> addAction(action_Open);
    
    //建立动作组
    QActionGroup * group = new QActionGroup(this);
    //向动作组中添加动作
    QAction * action_L = group -> addAction(tr("左对齐(&L)"));
    //设置动作checkable为true
    action_L -> setCheckable(true);
    QAction * action_R = group -> addAction(tr("右对齐(&R)"));
    action_R -> setCheckable(true);
    QAction * action_C = group -> addAction(tr("居中(&C)"));
    action_C -> setCheckable(true);
    //指定action_L为选中状态
    action_L -> setChecked(true);
    //像菜单中加入间隔器
    editMenu -> addSeparator();
    //向菜单中添加动作
    editMenu -> addAction(action_L);   
    editMenu -> addAction(action_R);
    editMenu -> addAction(action_C);
}
这里让“左对齐”“右对齐”和“居中”3个动作处于一个动作组中，然后设置“左对齐”动作为默认选中状态。可以运行程序查看效果。

4.工具栏

        工具栏QToolBar类提供了一个包含了一组控件的、可以移动的面板。前面已经看到可以将QAction对象添加到工具栏中，默认只是显示一个动作的图标，可以在QToolBar的属性栏中进行更改。在设计器中查看QToolBar的属性栏。

        其中， toolButtonStyle属性用来设置图标和相应文本的显示及其相对位置；

        movable属性用来设置状态栏是否可以移动；

        allowedArea用来设置允许停靠的位置；

        iconsize属性用来设置图标的大小；

        floatable属性用来设置是否可以悬浮。

        工具栏中除了可以添加动作外，还可以添加其他的窗口部件，下面来看一个例子。在前面的程序中的mainwindow. cpp文件中添加头文件：
#include <QToolButton>
#include <QSpinBox>
然后，在构造函数中继续添加如下代码：
MainWindow::MainWindow(QWidget *parent)
    : QMainWindow(parent)
    , ui(new Ui::MainWindow)
{
    ui->setupUi(this);
    QMenu * editMenu = ui -> menubar -> addMenu(tr("编辑(&E)"));
    QAction * action_Open = editMenu -> addAction(QIcon(":/image/image/2.jpg"),tr("打开文件(&O)"));
    action_Open -> setShortcut(QKeySequence("Ctrl + O"));
    ui -> toolBar -> addAction(action_Open);

    //建立动作组
    QActionGroup * group = new QActionGroup(this);
    //向动作组中添加动作
    QAction * action_L = group -> addAction(tr("左对齐(&L)"));
    //设置动作checkable为true
    action_L -> setCheckable(true);
    QAction * action_R = group -> addAction(tr("右对齐(&R)"));
    action_R -> setCheckable(true);
    QAction * action_C = group -> addAction(tr("居中(&C)"));
    action_C -> setCheckable(true);
    //指定action_L为选中状态
    action_L -> setChecked(true);
    //像菜单中加入间隔器
    editMenu -> addSeparator();
    //向菜单中添加动作
    editMenu -> addAction(action_L);
    editMenu -> addAction(action_R);
    editMenu -> addAction(action_C);

    //创建QToolButton
    QToolButton * toolBtn = new QToolButton(this);
    toolBtn -> setText(tr("color"));

    //创建一个弹出菜单
    QMenu * colorMenu = new QMenu(this);
    colorMenu -> addAction(tr("red"));
    colorMenu -> addAction(tr("green"));

    
    toolBtn -> setMenu(colorMenu);          //为toolbutton安装弹出菜单
    //设置弹出模式
    toolBtn -> setPopupMode(QToolButton::MenuButtonPopup);
    //向工具栏添加QToolButton按钮
    ui -> toolBar -> addWidget(toolBtn);
    //创建QSpinBox
    QSpinBox * spinbox = new QSpinBox(this);
    //向工具栏添加QSpinBox部件
    ui -> toolBar -> addWidget(spinbox);
}
这里创建了一个QToolButton类对象，并为它添加了一个弹出菜单，设置了弹出方式是在按钮旁边有一个向下的小箭头，可以按下这个箭头弹出菜单(默认的弹出方式是按下按钮一段时间才弹出菜单)。最后将它添加到了工具栏中。下面又在工具栏中添加了一个 QSpinBox部件，可以看到，往工具栏中添加部件可以使用addWidget()函数。

这里还要再说明一下QToolButton类。其实，当往工具栏中添加一个QAction类对象时就会自动创建了一个QToolButton实例，所以说工具栏上的动作就是一个QToolButton，这就是属性栏中会有toolButtonStyle的原因。