Qt Widgets——主窗口及其主要组成部分

时间：2021-06-10 23:56:01

Main Window and Related Classes

QAction

动作类，用于当做一个菜单项或工具项插入菜单或工具栏

QActionGroup

动作组，用于管理多个动作，设置它们之间的互斥性等

QWidgetAction

部件动作，继承自QAction，用于将小部件插入菜单或工具栏

QDockWidget

悬浮部件，程序运行后可鼠标拖动的部件

QMainWindow

主窗口，是其它部件的容器

QMdiArea

子区域，加到QMainWindow中，用于放置多个QMdiSubWindow子窗口

QMdiSubWindow

子窗口

QMenu

菜单

QMenuBar

菜单栏，存放多个菜单

QSizeGrip

管理顶层窗口尺寸，一般位于软件的右下角，状态栏最右边，鼠标可拖动它改变窗口大小

QStatusBar

状态栏

QToolBar

工具栏

以QMainWindow为中心，构成了传统界面的各部分，现将它们拖在一起记录。

以rar压缩软件界面为例，各部分组成如下：
Qt Widgets——主窗口及其主要组成部分

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

——————————————————————————————————————————————————————————————————

建立步骤：

为了构建传统界面，需要在建立工程某步时选择继承类，如下图。

Qt Widgets——主窗口及其主要组成部分

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

Qt Widgets——主窗口及其主要组成部分

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

Qt Widgets——主窗口及其主要组成部分

以下是效果图：

Qt Widgets——主窗口及其主要组成部分

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

以上就是建立一个传统界面的粗糙步骤

——————————————————————————————————————————————————————————————

QMainWindow

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

Qt Widgets——主窗口及其主要组成部分

对比（图中中间白色大框为一个QTableWidget表格小部件）：

Qt Widgets——主窗口及其主要组成部分

公有函数分类如下：
QMainWindow(QWidget * parent = , Qt::WindowFlags flags = )

    ~QMainWindow()

//设置菜单部分

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 = )

<p>QByteArray saveState(int version = ) const

bool restoreDockWidget(QDockWidget * dockwidget)  

</p>//其它

Qt::DockWidgetArea  corner(Qt::Corner corner) const

virtual QMenu * createPopupMenu()

DockOptions dockOptions() const

Qt::DockWidgetArea  dockWidgetArea(QDockWidget * dockwidget) const

bool    documentMode() const

QSize   iconSize() const

bool    isAnimated() const

bool    isDockNestingEnabled() const

QMenuBar *  menuBar() const

QWidget *   menuWidget() const

QStatusBar *    statusBar() const

QTabWidget::TabPosition tabPosition(Qt::DockWidgetArea area) const

QTabWidget::TabShape    tabShape() const

QList<QDockWidget *>  tabifiedDockWidgets(QDockWidget * dockwidget) const

void    tabifyDockWidget(QDockWidget * first, QDockWidget * second)

QWidget *   takeCentralWidget()

Qt::ToolBarArea toolBarArea(QToolBar * toolbar) const

bool    toolBarBreak(QToolBar * toolbar) const

Qt::ToolButtonStyle toolButtonStyle() const

1，enum Qt::ToolBarArea

Constant Value
Qt::LeftToolBarArea 0x1
Qt::RightToolBarArea 0x2
Qt::TopToolBarArea 0x4
Qt::BottomToolBarArea 0x8
Qt::AllToolBarAreas ToolBarArea_Mask
Qt::NoToolBarArea 0

2，enum Qt::ToolButtonStyle

Constant Value Description
Qt::ToolButtonIconOnly 0 只显示图标
Qt::ToolButtonTextOnly 1 Only display the text.
Qt::ToolButtonTextBesideIcon 2 The text appears beside the icon.
Qt::ToolButtonTextUnderIcon 3 文本显示在图标下方
Qt::ToolButtonFollowStyle 4 Follow the style.

3，enum Qt::DockWidgetArea
flags Qt::DockWidgetAreas

Constant Value
Qt::LeftDockWidgetArea 0x1
Qt::RightDockWidgetArea 0x2
Qt::TopDockWidgetArea 0x4
Qt::BottomDockWidgetArea 0x8
Qt::AllDockWidgetAreas DockWidgetArea_Mask
Qt::NoDockWidgetArea 0

4，enum QMainWindow::DockOption
flags QMainWindow::DockOptions

Constant Value Description
QMainWindow::AnimatedDocks 0x01 与animated相同
QMainWindow::AllowNestedDocks 0x02 与dockNestingEnabled相同
QMainWindow::AllowTabbedDocks 0x04 允许形成下方有tapBar的重合部件
QMainWindow::ForceTabbedDocks 0x08 Each dock area contains a single stack of tabbed dock widgets. In other words, dock widgets cannot be placed next to each other in a dock area. If this option is set, AllowNestedDocks has no effect.
QMainWindow::VerticalTabs 0x10 设置tabBar在竖直左方位置（默认在下方）

以rar压缩软件为例，用代码写出界面主要部分：

Qt Widgets——主窗口及其主要组成部分Qt Widgets——主窗口及其主要组成部分

以下代码只是用于理解，是很不合理的。主要测试各部分小部件的位置，外观等，以及mainwidow的形状配置保存

#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")));

    //connect(me1_act1,SIGNAL(triggered()),……

    QAction *me1_act2=menu1->addAction("保存压缩文件副本为(V)");

    me1_act2->setIcon(QIcon("://img/sava.ico"));

    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("://img/tool1.ico"),"添加");

    ui->mainToolBar->addSeparator();

    QAction *tb1_act2=ui->mainToolBar->addAction(QIcon("://img/tool2.ico"),"解压到");

    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();

}

void MainWindow::closeEvent(QCloseEvent *event)

{

    QSettings settings("大中华有限公司", "测试软件名");

    settings.setValue("geometry", saveGeometry());

    settings.setValue("windowState", saveState());

    settings.sync();

}

void MainWindow::readSettings()

{

    QSettings settings("大中华有限公司", "测试软件名");

    restoreGeometry(settings.value("geometry").toByteArray());

    restoreState(settings.value("windowState").toByteArray());

}

MainWindow::~MainWindow()

{

    delete ui;

}

　　

相关文章