qt之Vertical Layout

在 Qt 中使用垂直布局（QVBoxLayout）的完整指南如下：

1. 垂直布局（QVBoxLayout）的作用

用于将控件按**垂直方向（从上到下）**依次排列，自动管理控件的位置和大小，适配不同分辨率。

2. 代码实现步骤

2.1 纯代码示例

#include <QApplication>
#include <QWidget>
#include <QVBoxLayout>
#include <QPushButton>int main(int argc, char *argv[]) {QApplication app(argc, argv);// 创建主窗口QWidget window;window.setWindowTitle("Vertical Layout Demo");// 创建垂直布局QVBoxLayout *layout = new QVBoxLayout();// 添加控件QPushButton *button1 = new QPushButton("Button 1");QPushButton *button2 = new QPushButton("Button 2");QPushButton *button3 = new QPushButton("Button 3");layout->addWidget(button1);layout->addWidget(button2);layout->addWidget(button3);// 设置布局到窗口window.setLayout(layout);window.show();return app.exec();
}

2.2 关键方法说明

addWidget(QWidget*)：添加控件到布局末尾。
addStretch(int stretch = 0)：添加弹性空间（用于控件间距控制）。
setSpacing(int space)：设置控件之间的间隔。
setContentsMargins(int left, int top, int right, int bottom)：设置布局边距。

3. 在 Qt Designer 中使用垂直布局

打开 .ui 文件，拖入一个 QWidget（如主窗口）。
在右侧 Layouts 栏选择 Vertical Layout，拖放到窗体上。
将控件（如按钮、文本框）拖入布局区域。
右键点击父控件，选择 Lay Out → Lay Out Vertically。

4. 常见问题及解决

4.1 布局不生效

原因：未调用 setLayout() 或父控件未正确设置。
解决：确保父控件通过 setLayout(layout) 绑定布局。

4.2 控件间距不均匀

调整方法：

layout->setSpacing(10); // 设置控件间隔为10像素
layout->setContentsMargins(20, 20, 20, 20); // 设置布局边距

使用 addStretch() 添加弹性空间：

layout->addWidget(button1);
layout->addStretch(); // 按钮1和2之间添加弹性空间
layout->addWidget(button2);

4.3 动态添加/移除控件

// 添加新控件
QPushButton *newButton = new QPushButton("New Button");
layout->addWidget(newButton);// 移除控件
layout->removeWidget(oldButton);
delete oldButton;

5. 嵌套布局示例

垂直布局内嵌套水平布局：

QVBoxLayout *vLayout = new QVBoxLayout;
QHBoxLayout *hLayout = new QHBoxLayout;hLayout->addWidget(new QPushButton("Left"));
hLayout->addWidget(new QPushButton("Right"));
vLayout->addLayout(hLayout); // 将水平布局加入垂直布局
vLayout->addWidget(new QLineEdit("Input Field"));