Qt5 QMainWindow使用

在 Qt 中，我们将窗口和控件统称为部件（Widget）

窗口是指程序的整体界面，可以包含标题栏、菜单栏、工具栏、关闭按钮、最小化按钮、最大化按钮等。
控件是指按钮、复选框、文本框、表格、进度条等这些组成程序的基本元素。一个程序可以有多个窗口，一个窗口也可以有多个控件。
QWidget 是所有用户界面元素的基类，窗口和控件都是直接或间接继承自 QWidget，QMainWindow、QWidget、QDialog 三个类就是用来创建窗口的，可以直接使用也可以继承后再使用。
QMainWindow 窗口可以包含菜单栏、工具栏、状态栏、标题栏等，是最常见的窗口形式，可以作为GUI程序的主窗口。
QDialog 是对话框窗口的基类。对话框主要用来执行短期任务，或与用户进行互动，它可以是模态的也可以是非模态的。QDialog 没有菜单栏、工具栏、状态栏等。

这里我们先看QMainWindow

QMainWindow

主窗口及其主要组成部分


image.png

以QMainWindow为中心，构成了传统界面的各部分，以普通window上的文件夹为例。


image.png

最上一行，叫菜单栏，由“文件”、“编辑”等菜单组成，“帮助”菜单已点击，弹出菜单选项项，Qt中用动作类QAction来表示菜单选项。即QAction构成了菜单，菜单构成了菜单栏，QAction可加入文字，图片等构成漂亮的菜单项。QDockWidget悬浮部件较特殊，它在程序运行时，拖动可改变其位置。

工程建立选择继承类，如下图。


image.png

建成后，ui文件如下，“在这里输入”即是要求我们创建菜单，菜单栏下面一层即是默认的工具栏，很细的一横条，没有添加动作，所以很细小（最左方有一个小点）。


image.png

双击“在这里输入后”，可以写入文字，如下图，输入了创建了常用的“文件”。在下方五个按钮处的第一个新建一个动作，可以指定动作的名称，快捷键等，建完后，将它拖动到菜单或工具栏。


image.png

以下是效果图：

image.png

这时，只要将这个“动作”的“触发”信号连接到某个槽函数后，点击该菜单项或工具栏上的“新建”，就会执行槽函数。

QMainWindow

一个 主窗口各部分分布如图：


image.png

公有函数主要部分如下：

//设置菜单部分  
void setMenuBar(QMenuBar * menuBar)//带ui文件默认是有一个菜单条的，如果设置了这个之后，则默认的被覆盖，一个MainWindow只能有一个主菜单处于最上方  
void setMenuWidget(QWidget * menuBar)//覆盖默认菜单，用一个自定义的部件代替菜单，甚至可以用一个按钮，比较灵活，看不惯默认菜单的，可试试这个。  

//工具栏部分  
void addToolBar(Qt::ToolBarArea area, QToolBar * toolbar)//添加一个工具条，用枚举值Qt::ToolBarArea(见1)设定停靠区域，由图可见，停靠区分为上下左右四区域。  
void addToolBar(QToolBar * toolbar)//添加一个工具条（默认紧跟上一个工具条）  
QToolBar *  addToolBar(const QString & title)  
void addToolBarBreak(Qt::ToolBarArea area = Qt::TopToolBarArea)//添加一个Break（破裂; 间断; 或译为区域），这时，新添加的工具条将不再紧跟前一个工具条，而是另起一行。  
void insertToolBar(QToolBar * before, QToolBar * toolbar)//在before工具条后加一个  
void insertToolBarBreak(QToolBar * before)//添加分隔线  
void removeToolBar(QToolBar * toolbar)  
void removeToolBarBreak(QToolBar * before)  
void setToolButtonStyle(Qt::ToolButtonStyle toolButtonStyle)//设置工具条上显示模式，默认只有文件，可设置成图片或文字形式（见2）  
void setIconSize(const QSize & iconSize)//设置工具条上图标大小，在上一个函数设置图标模式后有效  


//可停靠窗口部件  
void addDockWidget(Qt::DockWidgetArea area, QDockWidget * dockwidget)//area枚举值见3  
void addDockWidget(Qt::DockWidgetArea area, QDockWidget * dockwidget, Qt::Orientation orientation)  
void removeDockWidget(QDockWidget * dockwidget)  
void setCorner(Qt::Corner corner, Qt::DockWidgetArea area)//让四个角落（corner）中一个区域"归属于"某个区域（area），具体看最下方例子  
void setDockOptions(DockOptions options)//设置停靠选项，比如允许动画或是否允许拖放重合成一个tab选项卡类型的部件，枚举值见4  
void setTabPosition(Qt::DockWidgetAreas areas, QTabWidget::TabPosition tabPosition)//设置形成的tab位置  
void setTabShape(QTabWidget::TabShape tabShape)  
void setDocumentMode(bool enabled)  
void splitDockWidget(QDockWidget * first, QDockWidget * second, Qt::Orientation orientation)//部件拖动至处于同一区域时，默认重合形成tab,利用这个，可将它们分开  

//设置中间部件  
void setCentralWidget(QWidget * widget)  
QWidget * centralWidget() const  

//添加状态栏  
void setStatusBar(QStatusBar * statusbar)  

//保存窗口形状信息  
bool restoreState(const QByteArray & state, int version = 0)  
<p>QByteArray saveState(int version = 0) const  
bool restoreDockWidget(QDockWidget * dockwidget)
1、enum Qt::ToolBarArea

toolbararea类型是qflags<toolbararea>的typedef。它存储一个或多个toolbararea值。


image.png
2、enum Qt::ToolButtonStyle

工具按钮的样式，描述按钮的文本和图标应如何显示。


image.png
3、enum Qt::DockWidgetArea

flags Qt::DockWidgetAreas
dockWidgetAreas类型是qFlags<dockWidgetArea>的typedef。它存储一个或多个DockWidgetArea值。


image.png
4、enum QMainWindow::DockOption

flags QMainWindow::DockOptions
此枚举包含指定qmainwindow的停靠行为的标志。


image.png
image.png

QMainWindow实例

#include "mainwindow.h"
#include "ui_mainwindow.h"
#include <QAction>
#include <QMenu>
#include <QIcon>
#include <QSize>
#include <QLabel>
#include <QDockWidget>
#include <QTableWidget>
#include <QSettings>


MainWindow::MainWindow(QWidget *parent) :
    QMainWindow(parent),
    ui(new Ui::MainWindow)
{
    ui->setupUi(this);
    //菜单栏部分
    QMenu *menu1=ui->menuBar->addMenu("文件(&F)");
    QAction *me1_act1=menu1->addAction("打开文件(O)");
    me1_act1->setShortcut(QKeySequence(tr("Ctrl+O")));

    QAction *me1_act2=menu1->addAction("保存(V)");
    me1_act2->setIcon(QIcon("://pic/save.png"));
    menu1->addSeparator();
    QAction *me1_act3=menu1->addAction("退出(X)");
    connect(me1_act3,SIGNAL(triggered()),this,SLOT(close()));
    ui->menuBar->addMenu("命令(&C)");


    //"文件"菜单部分
    QAction *tb1_act1=ui->mainToolBar->addAction(QIcon("://pic/new.png"),"新建");
    ui->mainToolBar->addSeparator();
    QAction *tb1_act2=ui->mainToolBar->addAction(QIcon("://pic/open.png"),"打开");
    setToolButtonStyle(Qt::ToolButtonTextUnderIcon);
    setIconSize(QSize(50,50));


    addToolBarBreak();
    toolBar=new QToolBar;
    toolBar->setObjectName("tb2");//设置对象名,用于保存配置
    toolBar->setToolButtonStyle(Qt::ToolButtonIconOnly);
    toolBar->setIconSize(QSize(20,20));
    addToolBar(toolBar);
    QAction *tb2_act1=toolBar->addAction(QIcon("://img/sharp.ico"),"");


    //添加中间主部件
    QTableWidget *tb1=new QTableWidget;
    setCentralWidget(tb1);


    //添加悬浮部件
    QDockWidget *dock1= new QDockWidget("上侧部件");
    addDockWidget(Qt::TopDockWidgetArea,dock1);
    QDockWidget *dock2_1= new QDockWidget("左侧部件1");
    addDockWidget(Qt::LeftDockWidgetArea,dock2_1);
    QDockWidget *dock2_2= new QDockWidget("左侧部件2");
    addDockWidget(Qt::LeftDockWidgetArea,dock2_2);
    splitDockWidget(dock2_1,dock2_2,Qt::Horizontal);
    QDockWidget *dock3= new QDockWidget("右侧部件");
    dock3->setFeatures(QDockWidget::DockWidgetVerticalTitleBar|QDockWidget::DockWidgetMovable);
    addDockWidget(Qt::RightDockWidgetArea,dock3);
    QDockWidget *dock4= new QDockWidget("下侧部件");
    addDockWidget(Qt::BottomDockWidgetArea,dock4);
    setCorner(Qt::BottomLeftCorner,Qt::LeftDockWidgetArea);//让左下角区域归于左边停靠区域
    dock1->setObjectName("dock1");
    dock2_1->setObjectName("dock2_1");
    dock2_2->setObjectName("dock2_2");
    dock3->setObjectName("dock3");
    dock4->setObjectName("dock4");


    //状态栏部分
    QLabel *lbl1=new QLabel("无状态");
    ui->statusBar->addWidget(lbl1);


    //读取窗口及部件形状与状态
    readSettings();
}

MainWindow::~MainWindow()
{
    delete ui;
}


void MainWindow::closeEvent(QCloseEvent *event)
{
    QSettings settings("1", "2");
    settings.setValue("geometry", saveGeometry());
    settings.setValue("windowState", saveState());
    settings.sync();
}

void MainWindow::readSettings()
{
    QSettings settings("1", "2");
    restoreGeometry(settings.value("geometry").toByteArray());
    restoreState(settings.value("windowState").toByteArray());
}

Qt 保存/恢复窗口的几何形状

上一个例子中我们使用了窗口的形状保存和恢复，这里主要使用geometry属性保存和恢复窗口的几何形状。在Windows中，基本上是存储QWindow::geometry()的结果，并在下次会话调用show()之前，调用QWindow::setGeometry()。

在X11中，这可能无法工作，因为一个不可见的窗口没有边框。后来窗口管理器将装饰窗口。当这种情况发生时，窗口朝向屏幕的底部/右下角移动取决于装饰框的大小。虽然X11提供了一种方法来避免这种转变，有些窗口管理器仍无法实现此功能。

当使用Qt Widgets时，Qt提供了保存和恢复一个窗口部件的几何形状和状态的函数。QWidget::saveGeometry()保存窗口的尺寸和最大化/全屏状态，而QWidget::restoreGeometry()用来恢复它。恢复函数还检查恢复几何形状是否超出可用的屏幕几何形状，如果超过了，则会适当地进行修改。

保存/恢复几何形状的方式有两种：
1、保存/恢复geometry()
2、保存/恢复pos()、size()

保存/恢复geometry()

保存几何形状

一般情况下，在程序退出之前，保存最后一次的几何形状和位置。

void MyMainWindow::closeEvent(QCloseEvent *event)
{
    QSettings settings("MyCompany", "MyApp");
    settings.setValue("geometry", saveGeometry());
    settings.setValue("windowState", saveState());
    QMainWindow::closeEvent(event);
}
恢复几何形状

在show()之前，然后读取上次保存的信息，一般在构造函数中调用。

void MainWindow::readSettings()
{
    QSettings settings("MyCompany", "MyApp");
    restoreGeometry(settings.value("myWidget/geometry").toByteArray());
    restoreState(settings.value("myWidget/windowState").toByteArray());
}

另一种方式是同时存储pos()和size()，并在show()之前调用QWidget::resize()和move() 。

保存/恢复pos()、size()

保存几何形状

一般情况下，在程序退出之前，保存最后一次的几何形状和位置。常在closeEvent()中调用。

void MainWindow::writeSettings()
{
    QSettings settings(QCoreApplication::organizationName(), QCoreApplication::applicationName());
    settings.setValue("geometry", saveGeometry());
}
恢复几何形状

在show()之前，然后读取上次保存的信息，一般在构造函数中调用。

void MainWindow::readSettings()
{
    QSettings settings(QCoreApplication::organizationName(), QCoreApplication::applicationName());
    const QByteArray geometry = settings.value("geometry", QByteArray()).toByteArray();
    if (geometry.isEmpty()) {
        const QRect availableGeometry = QApplication::desktop()->availableGeometry(this);
        resize(availableGeometry.width() / 3, availableGeometry.height() / 2);
        move((availableGeometry.width() - width()) / 2,
               (availableGeometry.height() - height()) / 2);
    } else {
          restoreGeometry(geometry);
    }
}
最后编辑于 ：
©著作权归作者所有,转载或内容合作请联系作者
平台声明：文章内容（如有图片或视频亦包括在内）由作者上传并发布，文章内容仅代表作者本人观点，简书系信息发布平台，仅提供信息存储服务。