qt之Vertical Layout

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

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

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

2. 代码实现步骤

2.1 纯代码示例

cpp 复制代码

#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 控件间距不均匀

调整方法 ：

cpp 复制代码

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

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

cpp 复制代码

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

4.3 动态添加/移除控件

cpp 复制代码

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

// 移除控件
layout->removeWidget(oldButton);
delete oldButton;

5. 嵌套布局示例

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

cpp 复制代码

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

6. 效果对比

无布局	使用垂直布局
控件堆叠，大小固定	控件自动排列，随窗口缩放

通过以上步骤，可以高效实现界面元素的垂直排列。如需进一步优化，可结合 QSizePolicy 调整控件的伸缩策略。