一 概述
setSpacing() 是 Qt 布局管理中的一个重要函数，用于设置布局中部件之间的间距。
二 主要用途
1 设置布局内部件间距
// 水平布局示例
QHBoxLayout *layout = new QHBoxLayout;
layout->setSpacing(10); // 设置部件之间间距为10像素
QPushButton *btn1 = new QPushButton("Button 1");
QPushButton *btn2 = new QPushButton("Button 2");
layout->addWidget(btn1);
layout->addWidget(btn2);
```
2 不同布局类的应用
// QVBoxLayout（垂直布局）
QVBoxLayout *vLayout = new QVBoxLayout;
vLayout->setSpacing(15); // 垂直方向间距15像素
// QHBoxLayout（水平布局）
QHBoxLayout *hLayout = new QHBoxLayout;
hLayout->setSpacing(20); // 水平方向间距20像素
// QGridLayout（网格布局）
QGridLayout *gridLayout = new QGridLayout;
gridLayout->setSpacing(10); // 同时设置水平和垂直间距
// 或分别设置
gridLayout->setHorizontalSpacing(15);
gridLayout->setVerticalSpacing(10);
```
三 关键特性
1 间距与边距的区别
QHBoxLayout *layout = new QHBoxLayout;
// setSpacing: 部件之间的内部间距
layout->setSpacing(10);
// setContentsMargins: 布局与外部的边距
layout->setContentsMargins(20, 20, 20, 20); // 左,上,右,下
四 默认值
不同平台可能有不同的默认间距，可以通过 QApplication::style() 获取系统推荐间距。
int defaultSpacing = QApplication::style()->pixelMetric(
QStyle::PM_LayoutHorizontalSpacing
);
五 实际示例
#include <QApplication>
#include <QWidget>
#include <QVBoxLayout>
#include <QPushButton>
int main(int argc, char *argv[]) {
QApplication app(argc, argv);
QWidget window;
QVBoxLayout *mainLayout = new QVBoxLayout(&window);
// 设置间距
mainLayout->setSpacing(20); // 按钮之间垂直间距20px
// 设置边距
mainLayout->setContentsMargins(30, 30, 30, 30); // 窗口内边距
// 添加按钮
QPushButton *btn1 = new QPushButton("Button 1");
QPushButton *btn2 = new QPushButton("Button 2");
QPushButton *btn3 = new QPushButton("Button 3");
mainLayout->addWidget(btn1);
mainLayout->addWidget(btn2);
mainLayout->addWidget(btn3);
window.setWindowTitle("Spacing Example");
window.resize(300, 200);
window.show();
return app.exec();
}
六 注意事项
1 负数值：设置为负数会使用样式的默认间距。
2 布局嵌套：子布局的间距不会影响父布局的间距设置。
3 QSpacerItem：对于更复杂的间距需求，可以使用 addSpacerItem()。
4 Stretch因子：结合 addStretch() 使用可以实现灵活的间距控制。
七 常用搭配
// 灵活的布局组合
QVBoxLayout *layout = new QVBoxLayout;
layout->addStretch(1); // 弹性空间
layout->addWidget(btn1);
layout->setSpacing(15); // 固定间距
layout->addWidget(btn2);
layout->addStretch(2); // 更多弹性空间
layout->addWidget(btn3);
八 总结
这个函数是 Qt 界面布局中控制元素间距的基本工具，合理使用可以使界面更加美观和专业。