如何将QScrollArea尺寸缩至最小？Qt界面布局优化求助

我开发了一款Qt应用，通过不同QGroupBox展示数据，最下方的"Data rates"组框内包含一个QScrollArea，其中标签数量可变（有时较多），因此需要滚动区域支持。代码可正常运行，但标签上下存在大量空间浪费（总共浪费113像素，上下各约30像素）。尝试设置尺寸策略、零边距仅起到微小作用，调整多个组件的尺寸策略和边距均无效果。

我希望将最下方的"Data rates"框缩至垂直方向的最小尺寸，目前使用scrollArea->setMaximumSize(1000000,53);是粗糙的临时方案，仅适配当前系统，会破坏动态UI，需要适配所有字体设置的合理解决方案。

代码文件 #

Makefile #

CPP        = g++
MOC        = /usr/libexec/qt6/moc
QTOPTS     = $(shell pkg-config Qt6Core Qt6Widgets Qt6Gui --cflags --libs)

testerr: qmainwindow.moc
    $(CPP) qmainwindow.cpp $(QTOPTS) -o $@
%.moc: %.h
    $(MOC) $? -o $@
clean:
    -rm *.moc testerr

qmainwindow.h #

#include <QtCore/QObject>
#include <QtCore/QTimer>
#include <QtWidgets/QApplication>
#include <QtWidgets/QBoxLayout>
#include <QtWidgets/QDialog>
#include <QtWidgets/QGridLayout>
#include <QtWidgets/QGroupBox>
#include <QtWidgets/QLabel>
#include <QtWidgets/QLayoutItem>
#include <QtWidgets/QPushButton>
#include <QtWidgets/QScrollArea>
#include <QtWidgets/QTextEdit>
#include <QtWidgets/QWidget>

class qMainWindow : public QWidget
{
Q_OBJECT

public:
  qMainWindow(QWidget *par = 0);
private slots:
  void actionPressed(void);
  void actionPressedHide(void) {DataRates->hide();};
private:
  int             Started;
  QPushButton *   Button;
  QPushButton *   Hide;
  QTextEdit *     List;
  QGroupBox *     DataRates;
  QWidget*        scrollAreaContent;
  QScrollArea*    scrollArea;
  QList<QLabel *> Labels;
};

qmainwindow.cpp #

#include "qmainwindow.moc"

int main(int argc, char *argv[])
{
  QApplication app(argc, argv);
  qMainWindow main;
  main.show();
  main.resize(700,550);
  return app.exec();
}

qMainWindow::qMainWindow(QWidget *par) : QWidget(par)
{
  QVBoxLayout *outerlayout = new QVBoxLayout;

  QGroupBox *box = new QGroupBox(tr("Data"));
  outerlayout->addWidget(box);
  List = new QTextEdit();
  QGridLayout *glayout = new QGridLayout();
  Button = new QPushButton(tr("Do"));
  connect(Button, SIGNAL(clicked(void)), this, SLOT(actionPressed(void)));
  glayout->addWidget(Button, 0, 0);
  Hide = new QPushButton(tr("Hide"));
  connect(Hide, SIGNAL(clicked(void)), this, SLOT(actionPressedHide(void)));
  glayout->addWidget(Hide, 0, 1);
  glayout->addWidget(List,1,0,1,2);
  box->setLayout(glayout);
  Started = 0;

  DataRates = new QGroupBox(tr("Data rates"));
  DataRates->hide();
  outerlayout->addWidget(DataRates);

  setLayout(outerlayout);
  List->document()->setPlainText(QString("Start SizeHint %1 Size %2\n")
  .arg(DataRates->sizeHint().height()).arg(DataRates->height()));
}

void qMainWindow::actionPressed(void)
{
  if(!Started)
  {
    QLayout *layoutOut;
    QLayout *layout;
    if(!DataRates->isHidden())
    {
      DataRates->hide();
      layout = DataRates->layout();
      if(layout)
      {
        QLayoutItem *child;
        while ((child = layout->takeAt(0)) != 0) {
          QWidget *w = child->widget();
          if(w)
            w->hide();
          delete child;
        }
        delete layout;
      }
    }
    else if((layout = DataRates->layout()))
      delete layout;
    layoutOut = new QBoxLayout(QBoxLayout::LeftToRight, DataRates);
    scrollAreaContent = new QWidget();
    layout = new QBoxLayout(QBoxLayout::LeftToRight, scrollAreaContent);
    layoutOut->setContentsMargins(0,0,0,0);
    scrollAreaContent->setLayout(layout);
    scrollArea = new QScrollArea;
    scrollArea->setWidgetResizable(true);
    scrollArea->setWidget(scrollAreaContent);
    scrollArea->setSizePolicy(QSizePolicy::Minimum, QSizePolicy::Minimum);

    layoutOut->addWidget(scrollArea);
    DataRates->setLayout(layoutOut);
    DataRates->hide();
    Started = 1;
  }

  QLabel *label = new QLabel("XXXXXXXX", DataRates);
  scrollAreaContent->layout()->addWidget(label);
  Labels.append(label);
  if(DataRates->isHidden())
  {
    DataRates->show();
    for(int p = 0; p < 1; ++p)
      Labels[p]->show();
  }
  QTextCursor tcursor(List->document());
  tcursor.movePosition(QTextCursor::End);
  tcursor.insertText(QString("Line SizeHint %1 Size %2\n")
  .arg(DataRates->sizeHint().height()).arg(DataRates->height()));
}

解决方案 #

1. 清除所有层级布局的默认边距 #

QGroupBox、QScrollArea及其内部容器的布局都带有默认边距，需要统一设置为0，消除不必要的留白：

• 给DataRates组框的外层布局设置边距：layoutOut->setContentsMargins(0, 0, 0, 0);
• 给scrollAreaContent的内部布局设置边距：layout->setContentsMargins(0, 0, 0, 0);
• 给QScrollArea自身设置边距：scrollArea->setContentsMargins(0, 0, 0, 0);

2. 优化QScrollArea的尺寸策略与滚动条行为 #

• 将垂直滚动条设为按需显示，避免默认占位：scrollArea->setVerticalScrollBarPolicy(Qt::ScrollBarAsNeeded);
• 调整尺寸策略，让垂直方向仅占用最小必要空间：scrollArea->setSizePolicy(QSizePolicy::Expanding, QSizePolicy::Minimum);

3. 约束内部容器与布局的尺寸 #

• 设置scrollAreaContent的尺寸策略为Minimum，确保它仅包裹内部标签：scrollAreaContent->setSizePolicy(QSizePolicy::Minimum, QSizePolicy::Minimum);
• 消除标签之间的间距：layout->setSpacing(0);

4. 消除QGroupBox标题带来的冗余空间 #

QGroupBox的标题会默认在顶部留出额外空间，通过样式表调整：

DataRates->setStyleSheet("QGroupBox { padding-top: 0px; margin-top: 0.5ex; } QGroupBox::title { top: -0.5ex; left: 10px; }");

修改后的关键代码片段 #

在actionPressed函数的初始化布局部分，补充以下设置：

layoutOut = new QBoxLayout(QBoxLayout::LeftToRight, DataRates);
layoutOut->setContentsMargins(0, 0, 0, 0); // 组框外层布局边距清零

scrollAreaContent = new QWidget();
layout = new QBoxLayout(QBoxLayout::LeftToRight, scrollAreaContent);
layout->setContentsMargins(0, 0, 0, 0); // 内容布局边距清零
layout->setSpacing(0); // 标签间距清零
scrollAreaContent->setLayout(layout);
scrollAreaContent->setSizePolicy(QSizePolicy::Minimum, QSizePolicy::Minimum);

scrollArea = new QScrollArea;
scrollArea->setWidgetResizable(true);
scrollArea->setWidget(scrollAreaContent);
scrollArea->setContentsMargins(0, 0, 0, 0); // 滚动区域边距清零
scrollArea->setVerticalScrollBarPolicy(Qt::ScrollBarAsNeeded);
scrollArea->setSizePolicy(QSizePolicy::Expanding, QSizePolicy::Minimum);

// 调整组框样式，消除标题导致的顶部冗余
DataRates->setStyleSheet("QGroupBox { padding-top: 0px; margin-top: 0.5ex; } QGroupBox::title { top: -0.5ex; left: 10px; }");

layoutOut->addWidget(scrollArea);
DataRates->setLayout(layoutOut);

内容的提问来源于stack exchange，提问作者Dirk Stöcker