QT-第三节 QMainWindow、对话框QDialog

QMainWindow

  1. 第一节讲过,QT创建项目有三大基类:QWidget、QMainWindow、QDialog
  2. 前面已经简单的介绍了QWidget基类,下面来介绍一下QMainWindow基类
    1. QMainWindow继承自QWidget
    2. QMainWindow是一个为用户提供主窗口程序的类,包含一个菜单栏(menu bar)、多个工具栏(tool bars)、多个锚接部件(dock widgets)(可以拖动的)、一个状态栏(status bar)及一个中心部件(central widget),是许多应用程序的基础,如文本编辑器,图片编辑器等。
    3. 如下图:

      图4

  3. 项目的简单创建
    1. 新建项目->选择Application->Qt Widgets Application->选择【Choose】
    2. 设置项目名称和路径
    3. 选择编译器类型:Kits
    4. Details:选择基类为QMainWindow,类名为:MyQMainWindow,”创建界面“不勾选,
    5. summary:先不设置git,完成
    6. 项目有4个文件:mymainwindow.h、mymainwindow.cpp、main.cpp和一个pro文件

菜单栏

  1. 一个主窗口最多只有一个菜单栏。位于主窗口顶部、主窗口标题栏下面。
    1. 创建菜单栏,通过QMainWindow类的menubar()函数获取主窗口菜单栏指针

       QMenuBar *	menuBar() const
      
    2. 创建菜单,调用QMenu的成员函数addMenu来添加菜单

       QAction* addMenu(QMenu * menu)
       QMenu* addMenu(const QString & title)
       QMenu* addMenu(const QIcon & icon, const QString & title)
      
    3. 创建菜单项,调用QMenu的成员函数addAction来添加菜单项

       QAction* activeAction() const
       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)
      
  2. Qt 并没有专门的菜单项类,只是使用一个QAction类,抽象出公共的动作。当我们把QAction对象添加到菜单,就显示成一个菜单项,添加到工具栏,就显示成一个工具按钮。用户可以通过点击菜单项、点击工具栏按钮、点击快捷键来激活这个动作。

工具栏

  1. 主窗口的工具栏上可以有多个工具条,通常采用一个菜单对应一个工具条的的方式,也可根据需要进行工具条的划分。
    1. 直接调用QMainWindow类的addToolBar()函数获取主窗口的工具条对象,每增加一个工具条都需要调用一次该函数。
    2. 插入属于工具条的动作,即在工具条上添加操作。
      1. 通过QToolBar类的addAction函数添加。
    3. 工具条是一个可移动的窗口,它的停靠区域由QToolBar的allowAreas决定,包括:
      1. Qt::LeftToolBarArea 停靠在左侧
      2. Qt::RightToolBarArea 停靠在右侧
      3. Qt::TopToolBarArea 停靠在顶部
      4. Qt::BottomToolBarArea 停靠在底部
      5. Qt::AllToolBarAreas 以上四个位置都可停靠
    4. 使用setAllowedAreas()函数指定停靠区域:

       setAllowedAreas(Qt::LeftToolBarArea | Qt::RightToolBarArea)
      
    5. 使用setMoveable()函数设定工具栏的可移动性:

       setMoveable(false)//工具条不可移动, 只能停靠在初始化的位置上
      

状态栏

  1. 派生自QWidget类,使用方法与QWidget类似,QStatusBar类常用成员函数:
  2. 状态栏也只能最多有一个

     void addWidget(QWidget * widget, int stretch = 0)
     //插入小部件
     int	insertWidget(int index, QWidget * widget, int stretch = 0)
     //删除小部件
     void removeWidget(QWidget * widget)
    

铆接部件

  1. 铆接部件 QDockWidget,也称浮动窗口,可以有多个。

     QDockWidget * dock = new QDockWidget("标题",this);
     addDockWidget(Qt::LeftDockWidgetArea,dock);
    dock->setAllowedAreas(Qt::LeftDockWidgetArea | Qt::RightDockWidgetArea | Qt::TopDockWidgetArea);  设置区域范围
    

核心部件(中心部件)

  1. 除了以上几个部件,中心显示的部件都可以作为核心部件,例如一个记事本文件,可以利用QTextEdit做核心部件

     QTextEdit * edit = new QTextEdit(this);
     setCentralWidget(edit);
    

代码举例:

#include "mymainwindow.h"
#include<QMenuBar>
#include<QToolBar>
#include<QStatusBar>
#include<QLabel>
#include<QDockWidget>
#include<QTextEdit>

MyMainWindow::MyMainWindow(QWidget *parent)
    : QMainWindow(parent)
{
    resize(600,400);
    /*----------------菜单栏----------------*/
    //1. 创建菜单栏
    //包含菜单栏,只能有一个
    QMenuBar *bar =  menuBar();
    //2. 将菜单栏放入窗口中
    this->setMenuBar(bar);
    //3. 网菜单栏中添加菜单(注意要导入头文件QMenuBar)
    QMenu *fileMenu =  bar->addMenu("文件");
    QMenu *editMenu =  bar->addMenu("编辑");
    //4. 添加菜单项
    //给文件菜单添加菜单项
    QAction *nesAction =  fileMenu->addAction("新建");
    //添加分割线
    fileMenu->addSeparator();
    QAction *openAction =  fileMenu->addAction("打开");

    /*----------------工具栏----------------*/
    //工具栏可以有多个
    //1. 创建工具栏,导入QToolBar文件
    QToolBar *tool = new QToolBar(this);
    //2. 往菜单栏中添加工具栏,工具栏可进行拖拽移动
//    addToolBar(tool);
    //toolBar默认在左边
    addToolBar(Qt::LeftToolBarArea,tool);
    //3. 限制toolbar的移动位置(只能左侧或者右侧移动)
    /*
     *  void setAllowedAreas(Qt::ToolBarAreas areas);
     * Qt::ToolBarAreas是一个枚举类型
    */
    tool->setAllowedAreas(Qt::LeftToolBarArea | Qt::RightToolBarArea);
    //4. 设置浮动(禁止浮动)
    tool->setFloatable(false);
    //5. 设置移动(不允许拖拽移动了)
//    tool->setMovable(false);

    //6. 工具栏添加工具项
    tool->addAction(nesAction);
    //添加分割线
    tool->addSeparator();
    tool->addAction(openAction);

 /*----------------状态栏----------------*/
    //1. 获取状态栏,只能有一个
    QStatusBar *statusbar =  statusBar();
    //2. 添加状态栏
    setStatusBar(statusbar);
    //3. 往状态栏中添加文本信息
    QLabel *label = new QLabel("左侧提示信息",this);
    //添加到左侧
    statusbar->addWidget(label);
    //添加在右侧
    QLabel *label1 = new QLabel("右侧提示信息",this);
    statusbar->addPermanentWidget(label1);

     /*----------------铆接部件----------------*/
    //铆接部件,移动窗口,可以有多个
    QDockWidget *dock = new QDockWidget("这是一个铆接部件",this);
    //添加铆接部件到窗口中:默认位置,铆接部件
    //注意:当没有核心部件时,铆接部件无论设置什么位置,都在上面
    addDockWidget(Qt::BottomDockWidgetArea,dock);
    //限制铆接部件在窗口中移动的位置
    dock->setAllowedAreas(Qt::TopDockWidgetArea|Qt::BottomDockWidgetArea);

    /*----------------核心部件----------------*/
    
    //文本编辑框 
    QTextEdit *text = new QTextEdit(this);
    setCentralWidget(text);
}

MyMainWindow::~MyMainWindow()
{

}

资源文件

  1. Qt 资源系统是一个跨平台的资源机制,用于将程序运行时所需要的资源以二进制的形式存储于可执行文件内部。
  2. 如果你的程序需要加载特定的资源(图标、文本翻译等),那么,将其放置在资源文件中,就再也不需要担心这些文件的丢失。
  3. 也就是说,如果你将资源以资源文件形式存储,它是会编译到可执行文件内部。

创建项目勾选UI的使用

  1. 新建一个项目QMainWindow_ui,继承QMainWindow基类,这一次勾选“创建界面”,即创建“mainwindow.ui”
  2. 可以看到新的项目中会多一个mainwindow.ui文件,相当于iOS的main.storyboard
  3. 而且mainwindow.cpp文件有所不一样
    1. 导入文件多了一个头文件#include "ui_mainwindow.h"
    2. 构造、析构函数不一样

       #include "mainwindow.h"
       #include "ui_mainwindow.h"
              
       //构造函数初始化列表多传了一个参数 new Ui::MainWindow
       MainWindow::MainWindow(QWidget *parent) :
           QMainWindow(parent),
           ui(new Ui::MainWindow)
       {
           //在当前窗口中初始化UI
           ui->setupUi(this);
       }
              
       MainWindow::~MainWindow()
       {
           //释放UI
           delete ui;
       }
      
  4. 双击打开mainwindow.ui文件,可以在UI界面上布局菜单栏、状态栏、工具栏等。
  5. 注意所有布局的空间在Qt的中心屏幕下面都有列表,如果想复用之前的直接在列表中往界面上拖拽即可
  6. 如何在代码中即mainwindow.cpp中找到相应的控件呢?
    1. 点击新添加的控件
    2. 在右下角可以看到该控件的属性,同时在这里可以修改该控件的一些性能,找到objectName(这个名字可以自己定义),比如当前的objectName为actionnew
    3. 在mainwindow.cpp的构造方法中找到

       MainWindow::MainWindow(QWidget *parent) :
           QMainWindow(parent),
           ui(new Ui::MainWindow)
       {
           //在当前窗口中初始化UI
           ui->setupUi(this);
           //找到菜单栏的文件菜单下的新建项
           ui->actionnew->setText("新建2");
       }
      

设置资源文件

  1. 创建、添加资源文件
    1. 使用 Qt Creator 可以很方便地创建资源文件。我们可以在工程上点右键,选择“添加新文件…(add new…)”,选择 “Qt ”,选择“Qt 资源文件(Qt Resoutce File)”:->close
    2. 设置文件名称:QMainWindow_uiResource 路径直接使用默认,点击完成
    3. 此时项目中多了一个Resources文件夹,且文件夹下有个QMainWindow_uiResource.qrc文件
    4. 将已经准备好的图片文件夹:images拖入到当前项目根目录下
    5. 右击QMainWindow_uiResource.qrc文件,选择“open in editor”
    6. 点击添加->添加前缀:/img ,下一步
    7. 点击添加->添加文件:选择之前拖入到根目录下的images文件夹->打开,选择images文件夹中的所有图片->点击打开即可
    8. 资源文件创建、添加完毕,编译一下,编译完之后可以在QMainWindow_uiResource.qrc展开的目录下看到添加的资源文件
  2. 使用资源文件
    1. 使用资源文件 ":+ /前缀名 +/文件名"

       MainWindow::MainWindow(QWidget *parent) : QMainWindow(parent), ui(new Ui::MainWindow)
       {
           //在当前窗口中初始化UI
           ui->setupUi(this);
           //找到菜单栏的文件菜单下的新建项
           ui->actionnew->setText("新建2");
           //使用资源文件":+ /前缀名 +/文件名"
           ui->actionnew->setIcon(QIcon(":/img/images/Luffy.png"));
       }
      

对话框QDialog

  1. 基本概念
    1. 对话框是 GUI 程序中不可或缺的组成部分。很多不能或者不适合放入主窗口的功能组件都必须放在对话框中设置。
    2. 对话框通常会是一个顶层窗口,出现在程序最上层,用于实现短期任务或者简洁的用户交互。
    3. Qt 中使用QDialog类实现对话框。就像主窗口一样,我们通常会设计一个类继承QDialog。
    4. QDialog(及其子类,以及所有Qt::Dialog类型的类)的对于其 parent 指针都有额外的解释:如果 parent 为 NULL,则该对话框会作为一个顶层窗口,否则则作为其父组件的子对话框(此时,其默认出现的位置是 parent 的中心)。
    5. 顶层窗口与非顶层窗口的区别在于,顶层窗口在任务栏会有自己的位置,而非顶层窗口则会共享其父组件的位置。
  2. 对话框分为模态对话框和非模态对话框。
    1. 模态对话框,就是会阻塞同一应用程序中其它窗口的输入。
      1. 模态对话框很常见,比如“打开文件”功能。你可以尝试一下记事本的打开文件,当打开文件对话框出现时,我们是不能对除此对话框之外的窗口部分进行操作的。
    2. 与此相反的是非模态对话框,例如查找对话框,我们可以在显示着查找对话框的同时,继续对记事本的内容进行编辑。

标准对话框

  1. 所谓标准对话框,是 Qt 内置的一系列对话框,用于简化开发。
  2. 事实上,有很多对话框都是通用的,比如打开文件、设置颜色、打印设置等。这些对话框在所有程序中几乎相同,因此没有必要在每一个程序中都自己实现这么一个对话框。
  3. Qt 的内置对话框大致分为以下几类:

     QColorDialog:		选择颜色;
     QFileDialog:			选择文件或者目录;
     QFontDialog:			选择字体;
     QInputDialog:		允许用户输入一个值,并将其值返回;
     QMessageBox:			模态对话框,用于显示信息、询问问题等;
     QPageSetupDialog:	为打印机提供纸张相关的选项;
     QPrintDialog:		打印机配置;
     QPrintPreviewDialog:打印预览;
     QProgressDialog:		显示操作过程。
    

自定义消息框

  1. Qt 支持模态对话框和非模态对话框。
  2. 模态与非模态的实现:
    1. 使用QDialog::exec()实现应用程序级别的模态对话框
    2. 使用QDialog::open()实现窗口级别的模态对话框
    3. 使用QDialog::show()实现非模态对话框。
  3. 模态对话框
    1. Qt 有两种级别的模态对话框:
      1. 应用程序级别的模态
        1. 当该种模态的对话框出现时,用户必须首先对对话框进行交互,直到关闭对话框,然后才能访问程序中其他的窗口。
      2. 窗口级别的模态
        1. 该模态仅仅阻塞与对话框关联的窗口,但是依然允许用户与程序中其它窗口交互。窗口级别的模态尤其适用于多窗口模式。
    2. 一般默认是应用程序级别的模态。
    3. 在下面的示例中,我们调用了exec()将对话框显示出来,因此这就是一个模态对话框。当对话框出现时,我们不能与主窗口进行任何交互,直到我们关闭了该对话框。

       QDialog dialog;
       	   dialog.setWindowTitle(tr("Hello, dialog!"));
       dialog.exec();
      
  4. 非模态对话框
    1. 下面我们试着将exec()修改为show(),看看非模态对话框:

       QDialog dialog(this);
       	   dialog.setWindowTitle(tr("Hello, dialog!"));
       	dialog.show();
      
    2. 是不是事与愿违?对话框竟然一闪而过!这是因为,show()函数不会阻塞当前线程,对话框会显示出来,然后函数立即返回,代码继续执行。
    3. 注意,dialog 是建立在栈上的,show()函数返回,MainWindow::open()函数结束,dialog 超出作用域被析构,因此对话框消失了。知道了原因就好改了,我们将 dialog 改成堆上建立,当然就没有这个问题了:

       QDialog *dialog = new QDialog;
       dialog->setWindowTitle(tr("Hello, dialog!"));
       dialog->show();
      
    4. 如果你足够细心,应该发现上面的代码是有问题的:dialog 存在内存泄露!dialog 使用 new 在堆上分配空间,却一直没有 delete。解决方案也很简单:将 MainWindow 的指针赋给 dialog 即可。还记得我们前面说过的 Qt 的对象系统吗?
    5. 不过,这样做有一个问题:如果我们的对话框不是在一个界面类中出现呢?由于QWidget的 parent 必须是QWidget指针,那就限制了我们不能将一个普通的 C++ 类指针传给 Qt 对话框。另外,如果对内存占用有严格限制的话,当我们将主窗口作为 parent 时,主窗口不关闭,对话框就不会被销毁,所以会一直占用内存。在这种情景下,我们可以设置 dialog 的WindowAttribute:

       QDialog *dialog = new QDialog;
       	dialog->setAttribute(Qt::WA_DeleteOnClose);
       	dialog->setWindowTitle(tr("Hello, dialog!"));
       	dialog->show();
      
      1. setAttribute()函数设置对话框关闭时,自动销毁对话框。
  5. 代码举例:

     MainWindow::MainWindow(QWidget *parent) : QMainWindow(parent), ui(new Ui::MainWindow)
     {
         ui->setupUi(this);
         //点击菜单项弹出对话框
         connect(ui->actionnew,&QAction::triggered,this,[=](){
        
            //弹出对话框有2中:模态、非模态
            //非模态对话框:当前对话框弹出的时候,仍然可以操作其他的对话框,Qt开发工具的->帮助->About Qt ...
            //模态对话框:当前对话框弹出的时候,必须处理完当前的对话框,否则不可以操作其他的对话框,Qt开发工具的->帮助->关于插件
        
     //        QDialog dlg(this);
             //以模态的方式弹出
     //        dlg.exec();
        
             //创建栈上了,会一闪而过,因为Lambda表达式执行完毕,就会释放对象dlg2;
     //        QDialog dlg2(this);
             //创建堆上就不会了
     //        QDialog *dlg2 = new QDialog(this); //这么写就会主窗口关闭时才会释放
             QDialog *dlg2 = new QDialog;
             //以非模态的方式弹出
             dlg2->show();
             //设置属性,由于在堆上,点击x的时候不会主动释放内存,必须整个窗口关闭时才会是释放
             //因此设置属性:当dlg点击x关闭时,释放对象
             dlg2->setAttribute(Qt::WA_DeleteOnClose);
             qDebug()<<"弹出对话框";
         });
     }
    

消息对话框QMessageBox

  1. QMessageBox用于显示消息提示。我们一般会使用其提供的几个 static 函数:

     //显示关于对话框。
     //这是一个最简单的对话框,其标题是 title,内容是 text,父窗口是 parent。对话框只有一个 OK 按钮。
     void about(QWidget * parent, const QString & title, const QString & text)
        
     //显示关于 Qt 对话框。该对话框用于显示有关 Qt 的信息。
     void aboutQt(QWidget * parent, const QString & title = QString()):
        
     //显示严重错误对话框
     //这个对话框将显示一个红色的错误符号。我们可以通过 buttons 参数指明其显示的按钮。默认情况下只有一个 Ok 按钮,我们可以使用StandardButtons类型指定多种按钮。
     StandardButton critical(QWidget * parent, const QString & title, const QString & text, StandardButtons buttons = Ok, StandardButton defaultButton = NoButton):
        
     //与QMessageBox::critical()类似,不同之处在于这个对话框提供一个普通信息图标。
     StandardButton information(QWidget * parent, const QString & title, const QString & text, StandardButtons buttons = Ok, StandardButton defaultButton = NoButton)
        
     //与QMessageBox::critical ()类似,不同之处在于这个对话框提供一个问号图标,并且其显示的按钮是“是”和“否”。
     StandardButton question(QWidget * parent,const QString & title, const QString & text, StandardButtons buttons = StandardButtons( Yes | No ), StandardButton defaultButton = NoButton) 
        
     //与QMessageBox::critical()类似,不同之处在于这个对话框提供一个黄色叹号图标。
     StandardButton warning(QWidget * parent, const QString & title, const QString & text, StandardButtons buttons = Ok, StandardButton defaultButton = NoButton)
    
  2. 我们可以通过下面的代码来演示下如何使用QMessageBox。

     if (QMessageBox::Yes == QMessageBox::question(this, tr("Question"), tr("Are you OK?"), QMessageBox::Yes | QMessageBox::No, QMessageBox::Yes)) 
     {
         QMessageBox::information(this, tr("Hmmm..."), 
     tr("I'm glad to hear that!"));
     } 
     else 
     {
         QMessageBox::information(this, tr("Hmmm..."), 
     tr("I'm sorry!"));
     }
    
  3. 我们使用QMessageBox::question()来询问一个问题。
    1. 这个对话框的父窗口是 this。
      1. QMessageBox是QDialog的子类,这意味着它的初始显示位置将会是在 parent 窗口的中央。
    2. 第二个参数是对话框的标题。
    3. 第三个参数是我们想要显示的内容。
    4. 第四个参数是关联的按键类型,我们可以使用或运算符( )指定对话框应该出现的按钮。比如我们希望是一个 Yes 和一个 No。
    5. 最后一个参数指定默认选择的按钮。
    6. 这个函数有一个返回值,用于确定用户点击的是哪一个按钮。按照我们的写法,应该很容易的看出,这是一个模态对话框,因此我们可以直接获取其返回值。
  4. QMessageBox类的 static 函数优点是方便使用,缺点也很明显:非常不灵活。我们只能使用简单的几种形式。为了能够定制QMessageBox细节,我们必须使用QMessageBox的属性设置 API。如果我们希望制作一个询问是否保存的对话框,我们可以使用如下的代码:

     QMessageBox msgBox;
     msgBox.setText(tr("The document has been modified."));
     msgBox.setInformativeText(tr("Do you want to save your changes?"));
     msgBox.setDetailedText(tr("Differences here..."));
     msgBox.setStandardButtons(QMessageBox::Save
                               | QMessageBox::Discard
                               | QMessageBox::Cancel);
     msgBox.setDefaultButton(QMessageBox::Save);
     int ret = msgBox.exec();
     switch (ret) 
     {
     case QMessageBox::Save:
         qDebug() << "Save document!";
         break;
     case QMessageBox::Discard:
         qDebug() << "Discard changes!";
         break;
     case QMessageBox::Cancel:
         qDebug() << "Close document!";
         break;
     }
    
    1. msgBox 是一个建立在栈上的QMessageBox实例。我们设置其主要文本信息为“The document has been modified.”,informativeText 则是会在对话框中显示的简单说明文字。下面我们使用了一个detailedText,也就是详细信息,当我们点击了详细信息按钮时,对话框可以自动显示更多信息。我们自己定义的对话框的按钮有三个:保存、丢弃和取消。然后我们使用了exec()是其成为一个模态对话框,根据其返回值进行相应的操作。
  5. 代码举例:

     MainWindow::MainWindow(QWidget *parent) :QMainWindow(parent), ui(new Ui::MainWindow)
     {
         ui->setupUi(this);
         //点击菜单项弹出对话框
         connect(ui->actionnew,&QAction::triggered,this,[=](){
             //使用标准的对话框
             //静态成员函数的调用 类名 :: 方法
             //1. 错误提示
     //        QMessageBox:: critical(this,"错误","critical");
             //2. 信息提示
     //        QMessageBox:: information(this,"信息提示","info");
             //3. 询问
             //参数1:父亲 ,2:标题 3;提示内容 4:按键类型  5. 默认,关联回车的默认
     //        if(QMessageBox:: Save ==  QMessageBox:: question(this,"问题","question",QMessageBox:: Save |QMessageBox::Cancel, QMessageBox::Cancel)){
     //            qDebug()<<"点击了保存";
     //        }else{
     //            qDebug()<<"点击了cancel";
     //        };
             //4. 警告
             //QMessageBox::warning(this,"警告","waring");
             //5. 选择颜色对话框
         //返回值为获取到的颜色
    //        QColor color = QColorDialog :: getColor(QColor(255,0,0));
         //打印选择的颜色
    //        qDebug()<<color.red()<<color.green()<<color.blue();
         //6. 选择文件
        QString path = QFileDialog:: getOpenFileName(this,"打开文件","C:\\Users\Administrator\\Desktop","(*.text *.png)");
         qDebug()<<path;
        
         });
     }
    

标准文件对话框

  1. QFileDialog,也就是文件对话框。在本节中,我们将尝试编写一个简单的文本文件编辑器,我们将使用QFileDialog来打开一个文本文件,并将修改过的文件保存到硬盘。
  2. 首先,我们需要创建一个带有文本编辑功能的窗口。借用我们前面的程序代码,应该可以很方便地完成:

     openAction = new QAction(QIcon(":/images/file-open"),tr("&Open..."), this);
     openAction->setStatusTip(tr("Open an existing file"));
        
     saveAction = new QAction(QIcon(":/images/file-save"), tr("&Save..."), this);
     saveAction->setStatusTip(tr("Save a new file"));
        
     QMenu *file = menuBar()->addMenu(tr("&File"));
     file->addAction(openAction);
     file->addAction(saveAction);
        
     QToolBar *toolBar = addToolBar(tr("&File"));
     toolBar->addAction(openAction);
     toolBar->addAction(saveAction);
        
     textEdit = new QTextEdit(this);
     setCentralWidget(textEdit);
    
    1. 我们在菜单和工具栏添加了两个动作:打开和保存。接下来是一个QTextEdit类,这个类用于显示富文本文件。也就是说,它不仅仅用于显示文本,还可以显示图片、表格等等。不过,我们现在只用它显示纯文本文件。
    2. QMainWindow有一个setCentralWidget()函数,可以将一个组件作为窗口的中心组件,放在窗口中央显示区。显然,在一个文本编辑器中,文本编辑区就是这个中心组件,因此我们将QTextEdit作为这种组件。
  3. 我们使用connect()函数,为这两个QAction对象添加响应的动作:

     connect(openAction, &QAction::triggered, 
     this, &MainWindow::openFile);
     connect(saveAction, &QAction::triggered, 
     this, &MainWindow::saveFile);
    
  4. 下面是最主要的openFile()和saveFile()这两个函数的代码:

     //打开文件
     void MainWindow::openFile()
     {
         QString path = QFileDialog::getOpenFileName(this,
                    tr("Open File"), ".", tr("Text Files(*.txt)"));
         if(!path.isEmpty()) 
     {
             QFile file(path);
             if (!file.open(QIODevice::ReadOnly | QIODevice::Text)) 
     {
                 QMessageBox::warning(this, tr("Read File"),
                              tr("Cannot open file:\n%1").arg(path));
                 return;
             }
             QTextStream in(&file);
             textEdit->setText(in.readAll());
             file.close();
         } 
     else 
     {
             QMessageBox::warning(this, tr("Path"),
                                  tr("You did not select any file."));
          }
     }
        
     //保存文件
     void MainWindow::saveFile()
     {
         QString path = QFileDialog::getSaveFileName(this,
                    tr("Open File"), ".", tr("Text Files(*.txt)"));
         if(!path.isEmpty()) 
     {
             QFile file(path);
             if (!file.open(QIODevice::WriteOnly | QIODevice::Text)) 
     {
                 QMessageBox::warning(this, tr("Write File"),
                              tr("Cannot open file:\n%1").arg(path));
                 return;
             }
             QTextStream out(&file);
             out << textEdit->toPlainText();
             file.close();
         } 
     else 
     {
             QMessageBox::warning(this, tr("Path"),
                                  tr("You did not select any file."));
         }
     }
    
  5. 在openFile()函数中,我们使用QFileDialog::getOpenFileName()来获取需要打开的文件的路径。这个函数原型如下:

     QString getOpenFileName(QWidget * parent = 0, const QString & caption = QString(), const QString & dir = QString(), const QString & filter = QString(), QString * selectedFilter = 0, Options options = 0)
    
    1. 不过注意,它的所有参数都是可选的,因此在一定程度上说,这个函数也是简单的。这六个参数分别是:
    2. parent:父窗口。
      1. Qt 的标准对话框提供静态函数,用于返回一个模态对话框;
    3. caption:对话框标题;
    4. dir:对话框打开时的默认目录
      1. “.” 代表程序运行目录
      2. “/” 代表当前盘符的根目录(特指 Windows 平台;Linux 平台当然就是根目录),这个参数也可以是平台相关的,比如“C:\”等;
    5. filter:过滤器。
      1. 我们使用文件对话框可以浏览很多类型的文件,但是,很多时候我们仅希望打开特定类型的文件。
      2. 比如,文本编辑器希望打开文本文件,图片浏览器希望打开图片文件。过滤器就是用于过滤特定的后缀名。
      3. 如果我们使用“Image Files(*.jpg *.png)”,则只能显示后缀名是 jpg 或者 png 的文件。如果需要多个过滤器,使用“;;”分割,比如“JPEG Files(*.jpg);;PNG Files(*.png)”;
    6. selectedFilter:默认选择的过滤器;
    7. options:对话框的一些参数设定
      1. 比如只显示文件夹等等,它的取值是enum QFileDialog::Option,每个选项可以使用 运算组合起来。
    8. QFileDialog::getOpenFileName()返回值是选择的文件路径。我们将其赋值给 path。通过判断 path 是否为空,可以确定用户是否选择了某一文件。只有当用户选择了一个文件时,我们才执行下面的操作。
    9. 在saveFile()中使用的QFileDialog::getSaveFileName()也是类似的。使用这种静态函数,在 Windows、Mac OS 上面都是直接调用本地对话框,但是 Linux 上则是QFileDialog自己的模拟。这暗示了,如果你不使用这些静态函数,而是直接使用QFileDialog进行设置,那么得到的对话框很可能与系统对话框的外观不一致。这一点是需要注意的。
Table of Contents