Qt 实战（5）布局管理器 | 5.2、深入解析Qt布局管理器

前言：

在Qt框架中，布局管理器（Layout Manager）是一个强大的工具，用于动态调整和管理窗口部件（widgets）的位置和大小。随着用户调整窗口大小或在不同分辨率和DPI（每英寸点数）的屏幕上运行程序，布局管理器能够自动调整其内部部件的排列，确保界面的一致性和可读性。本文将详细介绍Qt中的布局管理器，并探讨其使用方法和最佳实践。

一、深入解析Qt布局管理器

1、为什么要使用布局管理器？

在Qt中，窗口部件（widgets）是用户界面的基本构建块，如按钮、文本框、标签等。然而，仅仅将这些部件简单地放置在窗口中并不足以创建一个功能完善且易于使用的用户界面。当窗口大小改变或在不同DPI的屏幕上显示时，这些部件可能会变得混乱或难以辨认。

为了解决这个问题，Qt引入了布局管理器。布局管理器是一种特殊的窗口部件，它负责控制其内部部件的排列和大小。当窗口大小改变时，布局管理器会自动调整其内部部件的位置和大小，以保持界面的整洁和一致性。这使得开发人员能够更轻松地创建适应不同设备和分辨率的用户界面。

2、布局管理器类型

Qt提供了几种不同类型的布局管理器，每种都有其独特的特点和适用场景：

• QHBoxLayout：水平布局管理器，将部件水平排列。它可以根据需要添加间距和对齐方式，使部件在水平方向上均匀分布。
• QVBoxLayout：垂直布局管理器，将部件垂直排列。与QHBoxLayout类似，它也可以添加间距和对齐方式。
• QGridLayout：网格布局管理器，将部件放置在二维网格中。它允许开发人员指定行和列的数量，并控制部件在网格中的位置和对齐方式。
• QFormLayout：表单布局管理器，通常用于创建表单界面。它可以将标签（QLabel）和字段（如QTextEdit、QLineEdit等）配对，并自动调整它们的位置和大小。
• QStackedLayout：堆叠布局管理器，将多个部件堆叠在一起，但一次只显示一个部件。它通常用于实现选项卡（tab）或向导（wizard）界面。

Qt 共提供了 5 种布局管理器，每种布局管理器对应一个类，分别是 QVBoxLayout、QHBoxLayout、QGridLayout、QFormLayout 和 QStackedLayout，继承关系如下图：

3、布局管理器用法详解

3.1、QBoxLayout（垂直与水平布局）

垂直布局管理器常用操作，如下：

// 1、添加控件
void addWidget(QWidget *widget, int stretch = 0, Qt::Alignment alignment = Qt::Alignment())

// 2、添加子布局
void addLayout(QLayout *layout, int stretch = 0)

// 3、设置边界
void setContentsMargins(int left, int top, int right, int bottom)
void setMargin(int margin)

// 4、设置间距
void addSpacing(int size)    // 设置固定间隔
void addStretch(int stretch = 0)    // 设置可伸缩间距，stretch是伸缩因子

// 5、设置布局方向
void setDirection(Direction direction)

// 6、设置拉伸系数
void setStretch(int index, int stretch)
bool setStretchFactor(QWidget *widget, int stretch)
bool setStretchFactor(QLayout *layout, int stretch)

// 7、设置布局策略
void setSizeConstraint(SizeConstraint)

3.2、QGridLayout（网格布局）

网格布局管理器常用操作，如下：

// 1、添加控件
void addWidget(QWidget *widget, int row, int column, Qt::Alignment alignment = Qt::Alignment())
void addWidget(QWidget *widget, int fromRow, int fromColumn, int rowSpan, int columnSpan, 
	Qt::Alignment alignment = Qt::Alignment())

// 2、添加子布局
void addLayout(QLayout *layout, int row, int column, Qt::Alignment alignment = Qt::Alignment())
void addLayout(QLayout *layout, int row, int column, int rowSpan, int columnSpan, 
	Qt::Alignment alignment = Qt::Alignment())

// 3、设置拉伸系数
void setColumnStretch(int column, int stretch)    // 给指定列设置拉伸系数
void setRowStretch(int row, int stretch)    // 给指定行设置拉伸系数

3.3、QFormLayout（表单布局）

表单布局管理器常用操作，如下：

// 1、添加控件
// 将指定的field控件和存储标签的label控件添加到表单控件中的末尾
void addRow(QWidget *label, QWidget *field)    
 // 将指定的 field 控件和 labelText 标签添加到表单控件的末尾
void addRow(const QString &labelText, QWidget *field)   

// 2、设置标签显示格式，默认标签位于控件的左侧
void setRowWrapPolicy(RowWrapPolicy policy)

3.4、QStackedLayout（分组布局管理器）

分组布局管理器常用操作，如下：

// 1、添加控件
int addWidget(QWidget *widget)

// 2、设置显示样式
void setStackingMode(StackingMode stackingMode)

4、总结

Qt布局管理器是创建灵活和可适应不同设备和分辨率的用户界面的关键工具。通过合理地使用不同类型的布局管理器、嵌套布局、间距和对齐方式以及测试不同环境，开发人员可以创建出功能完善且易于使用的用户界面。希望本文能帮助您更深入地了解Qt布局管理器并为您的开发工作提供有用的指导。