QT学习笔记（2）布局管理

QT学习笔记（2）——布局管理

---

2.1 分割窗体 QSplitter类

头文件:#include
QSplitter:分割窗口对象

 QSplitter *splitterMain = new QSplitter(Qt::Horizontal,0); //0为无主窗口
 QSplitter *splitterRight = new QSplitter(Qt::Vertical,splitterMain);

Qt::Horizontal:水平分割
Qt::Vertical:垂直分割

QTextEdit:文本编辑对象（一种高级的文本查看器、编辑器，可以显示图像，列表和表格）

QTextEdit *textLeft = new QTextEdit("Left Widget",splitterMain);    //创建对象，文本、主窗口
textLeft->setAlignment(Qt::AlignCenter);    //对齐方式

Qt::AlignLeft:左对齐。
Qt::AlignRight:右对齐。
Qt::AlignCenter:文字居中(Qt::AlignHCenter为水平居中，Qt::AlignVCenter为垂直居中）。
Qt::AlignUp:文字与顶部对齐。
Qt::AlignBottom:文字与底部对齐。

---

2.2 停靠窗体 QDockWidget类

头文件:#include
一般流程：

1. 创建一个 QDockWidget 对象的停靠窗体
   QDockWidget *dock = new QDockWidget("DockWindow1",this);
2. 设置此停靠窗体的属性，通常调用 setFeatures() 及 setAllowedAreas() 两种方法。

dock->setFeatures(QDockWidget::DockWidgetMovable);  //可移动
dock->setAllowedAreas(Qt::LeftDockWidgetArea|Qt::RightDockWidgetArea);  //停靠在左or右侧

setFeatures()方法设置停靠窗体的特性:
函数原型:void setFeatures(DockWidgetFeatures features)
QDockWidget::DockWidgetClosable:停靠窗体可关闭。
DockWidget::DockWidgetMovable:停靠窗体可移动。
QDockWidget::DockWidgetFloatable:停靠窗体可浮动。
QDockWidget::AllDockWidgetFeatures:此参数表示拥有停靠窗体的所有特性。
QDockWidget::NoDockWidgetFeatures:不可移动、不可关闭、不可浮动。
此参数可采用或 (|) 的方式进行多个特性的设定。

setAllowedAreas()方法设置停靠窗体可停靠的区域:
函数原型:void setAllowedAreas (Qt:: DockWidgetAreas areas)
Qt::LeftDockWidgetArea:可在主窗口的左侧停靠。
Qt::RightDockWidgetArea:可在主窗口的右侧停靠。
Qt::TopDockWidgetArea:可在主窗口的顶部停靠。
Qt::BottomDockWidgetArea:可在主窗口的底部停靠。
Qt::AllDockWidgetArea:可在主窗口任意（以上四个）部位停靠。
Qt::NoDockWidgetArea:只可停靠在插入处。｀
也可采用或 (|) 的方式进行多个特性的设定。

3. 新建一个要插入停靠窗体的控件，常用的有 QListWidget 和 QTextEdit

QTextEdit *te1 = new QTextEdit();
te1->setText("window1 can be moved butween docks by user");

4. 将控件插入停靠窗体，调用 QDockWidget的setWidget()方法
   dock->setWidget(te1);
5. 使用 addDockWidget() 方法在 MainWindow 中加入此停靠窗体
   addDockWidget(Qt::RightDockWidgetArea,dock);

---

2.3 堆栈窗体 QStackedWidget类

头文件:#include
堆栈窗体多与列表框 QListWidget 及下拉列表框 QComboBox 配合使用。
接口：

int addWidget(QWidget * widget) 添加页面，并返回页面对应的索引
int count() const 获取页面数量
int currentIndex() const 获取当前页面的索引
QWidget * currentWidget() const 获取当前页面
int indexOf(QWidget * widget) const 获取QWidget页面所对应的索引
int insertWidget(int index, QWidget * widget) 在索引index位置添加页面 void
removeWidget(QWidget * widget) 移除QWidget页面，并没有被删除，只是从布局中移动，从而被隐藏。
QWidget * widget(int index) const 获取索引index所对应的页面

信号：

void currentChanged(int index) 当前页面发生变化时候发射，index为新的索引值
void widgetRemoved(int index) 页面被移除时候发射，index为页面对应的索引值

槽函数：

void setCurrentIndex(int index) 设置索引index所在的页面为当前页面
void setCurrentWidget(QWidget * widget) 设置QWidget页面为当前页面

一般使用方法：

• 根据currentWidget()来判断当前页面，然后通过setCurrentWidget()来设置需要显示的页面。
• 根据currentIndex()来判断当前页面索引，然后通过setCurrentIndex()来设置需要显示的页面。

一个QListWidget和QStrackedWidget结合的例子如下：stackdlg.h和stackdlg.cpp文件

#ifndef STACKDLG_H
#define STACKDLG_H

#include 
#include
#include
#include

class StackDlg : public QDialog
{
    Q_OBJECT

public:
    StackDlg(QWidget *parent = nullptr);
    ~StackDlg();

private:
    QListWidget *list;
    QStackedWidget *stack;
    QLabel *label1;
    QLabel *label2;
    QLabel *label3;
};
#endif // STACKDLG_H

#include "stackdlg.h"
#include 

StackDlg::StackDlg(QWidget *parent)
    : QDialog(parent)
{
    setWindowTitle("StackedWidget");
    list = new QListWidget(this);
    //新建三个QListWidget对象，作为选择项
    list->insertItem(0,"Window1");
    list->insertItem(1,"Window2");
    list->insertItem(2,"Window3");
    //新建三个QLabel对象，作为显示的堆栈窗体
    label1 = new QLabel("WindowTest1");
    label2 = new QLabel("WindowTest2");
    label3 = new QLabel("WindowTest3");
    stack = new QStackedWidget(this);   //新建堆栈窗体对象
    //Label对象插入堆栈窗体
    stack->addWidget(label1);
    stack->addWidget(label2);
    stack->addWidget(label3);
    QHBoxLayout *mainLayout = new QHBoxLayout(this);    //水平布局
    //布局对话框
    mainLayout->setMargin(5);
    mainLayout->setSpacing(5);
    mainLayout->addWidget(list);
    mainLayout->addWidget(stack,0,Qt::AlignHCenter);
    //setStretchFactor()可伸缩控件，参数1控件名，参数2>0为可伸缩
    mainLayout->setStretchFactor(list,1);
    mainLayout->setStretchFactor(stack,2);
    //槽函数连接，堆栈窗体index按插入的顺序从 起依次排序，与QListWidget的条目排序相一致。
    connect(list,SIGNAL(currentRowChanged(int)),stack,SLOT(setCurrentIndex(int)));
}
StackDlg::~StackDlg()
{
}

---

2.4 基本布局 QLayout类

Qt 提供了 QHBoxLayout 类、 QVBoxLayout 类及 QGridLayout 类等的基本布局管理，分别是水平排列布局、垂直排列布局和网格排列布局，其继承关系如图：

QLayout

QBoxLayout

QGridLayout

QHBoxLayout

QVBoxLayout

布局中常用的方法有addWidget()和add.Layout()，
addWidget()方法用于加入需要布局的控件

void addWidget (
    QWidget *widget,    //插入的控件对象
    int fromRow,    //插入的行
    int fromColumn, //插入的列
    int rowSpan,    //占用的行数
    int columnSpan, //占用的列数
    Qt::Alignment alignment=0   //控件对齐方法
)

addLayout()方法用于加入子布局

void addLayout(
    QLayout *layout,    //插入的子布局对象
    int row,    //插入的起始行
    int column, //插入的起始列
    int rowSpan,    //占用的行数
    int columnSpan, //占用的列数
    Qt::Alignment alignment=0  //对齐方法
)