如何使用setupUi或ui输出来创建没有父部件的独立布局

Question

uic从.ui文件生成的输出总是在现有小部件上安装布局和子小部件。当您打算直接在widget上添加布局/子元素时，这非常有效:

#include "ui_form.h"
QWidget widget;
Ui::Form ui;
ui.setupUi(&widget);

唉，有时候中间的小部件是不必要的。首先，小部件上的布局有非零边距，所以如果你打算将Ui::Form的内容插入布局，你必须重置边距:

QWidget top;
QVBoxLayout layout{&top};
QWidget widget;
Ui::Form ui;
ui.setupUi(&widget);
widget.layout()->setContentsMargins(0,0,0,0);
layout.addWidget(&widget);

此外，在这种情况下，中间的小部件是完全不必要的。假设我们有不需要顶级部件的setupUi(在Qt 5.7中，当传递一个nullptr时，它会崩溃)。我们可以这样使用它:

QWidget top;
QVBoxLayout layout{&top};
Ui::Form ui;
ui.setupUi(nullptr);
layout.addLayout(ui.layout); // assuming `layout` is the top-level layout there

我已经检查了uic，它不支持在没有顶级小部件的情况下发出代码。的确，所需的补丁很小。

然而，有没有办法实现nullptr的效果-接受setupUi而不打补丁Qt?

以免有人认为这是一个虚构的问题:这个问题部分是由YUView的代码提示的。在那里，传递给setupUi的parentWidget已经有一个布局，目的是在setupUi完成后将表单的布局添加到另一个布局。从setupUi内部调用的QWidget::setLayout拒绝设置新的布局，发出警告，尽管如此，事情还是发生了。代码是脆弱的，因为它依赖于Qt代码以正确的方式导致所需的结果。

Answer 1

是。使我们能够这样做的关键观察是:

1. childLayout可以从父布局中移除:

   childLayout->setParent(nullptr);
   

2. 无父布局将在将其添加到小部件或具有非空parentWidget()的布局中时，代表其子布局。

因此，我们需要向表单添加一个额外的顶级包装器布局，然后从中取消目标顶级布局的父级，并删除包装器。dumpObjectTree报告的表单结构是:

QWidget::Form 
    QVBoxLayout::wrapper 
        QVBoxLayout::layout 
            QHBoxLayout::horizontalLayout 
    QLabel::label 
    QLabel::label_2 
    QLabel::label_3

测试用例:

// https://github.com/KubaO/stackoverflown/tree/master/questions/layout-take-40497358
#include <QtWidgets>
#include "ui_form.h"
QLayout * takeLayout(QWidget *);
int main(int argc, char ** argv)
{
   QApplication app{argc, argv};
   QWidget parent;
   QHBoxLayout layout{&parent};
   Ui::Form ui;
   {
      QWidget w;
      ui.setupUi(&w);
      w.dumpObjectTree();
      if (true) {
         ui.layout->setParent(nullptr);
         delete ui.wrapper;
         layout.addLayout(ui.layout);
      } else {
         layout.addLayout(takeLayout(&w));
      }
   }
   parent.show();
   return app.exec();
}

如果你想把这个功能提出来，你可以用一个模板setupLayout函数来代替setupUi。上面的测试用例将变成:

   QWidget parent;
   QHBoxLayout layout{&parent};
   Ui::Form ui;
   layout.addLayout(setupLayout(&ui));
   parent.show();

setupLayout是:

//*** Interface
QLayout * setupLayout_impl(void * ui, void(*setupUi)(void * ui, QWidget * widget));
// Extracts the top layout from a Ui class generated by uic. The top layout must
// be enclosed in a wrapper layout.
template <typename Ui> QLayout * setupLayout(Ui * ui) {
  struct Helper {
    static void setupUi(void * ui, QWidget * widget) {
      reinterpret_cast<Ui*>(ui)->setupUi(widget);
    }
  };
  return setupLayout_impl(static_cast<void*>(ui), &Helper::setupUi);
}
//*** Implementation
static void unparentWidgets(QLayout * layout) {
  const int n = layout->count();
  for (int i = 0; i < n; ++i) {
    QLayoutItem * item = layout->itemAt(i);
    if (item->widget()) item->widget()->setParent(0);
    else if (item->layout()) unparentWidgets(item->layout());
  }
}
QLayout * setupLayout_impl(void * ui, void(*setupUi)(void * ui, QWidget * widget))
{
  QWidget widget;
  setupUi(ui, &widget);
  QLayout * wrapperLayout = widget.layout();
  Q_ASSERT(wrapperLayout);
  QObjectList const wrapperChildren = wrapperLayout->children();
  Q_ASSERT(wrapperChildren.size() == 1);
  QLayout * topLayout = qobject_cast<QLayout*>(wrapperChildren.first());
  Q_ASSERT(topLayout);
  topLayout->setParent(0);
  delete wrapperLayout;
  unparentWidgets(topLayout);
  Q_ASSERT(widget.findChildren<QObject*>().isEmpty());
  return topLayout;
}

如果你不能或不愿意改变表单的结构怎么办?您可以使用Qt的内部实现一个takeLayout函数，该函数剥离小部件的布局并返回它，而不附加到小部件上。请注意，私有QWidget::takeLayout是不够的，因为它返回一个带有topLevel标志集的布局:这样的布局只能直接安装在小部件上，当试图将它们添加到布局(作为子布局)时，将无法断言。方法如下:

#include <private/qwidget_p.h>
#include <private/qlayout_p.h>
class WidgetHelper : private QWidget {
   struct LayoutHelper : private QLayout {
      static void resetTopLevel(QLayout * l) {
         auto d = static_cast<QLayoutPrivate*>(static_cast<LayoutHelper*>(l)->d_ptr.data());
         d->topLevel = false;
      }
   };
public:
   static QLayout * takeLayout(QWidget * w) {
      auto d = static_cast<QWidgetPrivate*>(static_cast<WidgetHelper*>(w)->d_ptr.data());
      auto l = w->layout();
      if (!l) return nullptr;
      d->layout = 0;
      l->setParent(nullptr);
      LayoutHelper::resetTopLevel(l);
      return l;
   }
};
QLayout * takeLayout(QWidget * w) { return WidgetHelper::takeLayout(w); }

form.ui如下图所示:

<?xml version="1.0" encoding="UTF-8"?>
<ui version="4.0">
 <class>Form</class>
 <widget class="QWidget" name="Form">
  <layout class="QVBoxLayout" name="wrapper">
   <item>
    <layout class="QVBoxLayout" name="layout">
     <item>
      <widget class="QLabel" name="label">
       <property name="text">
        <string>Top</string>
       </property>
      </widget>
     </item>
     <item>
      <layout class="QHBoxLayout" name="horizontalLayout">
       <item>
        <widget class="QLabel" name="label_2">
         <property name="text">
          <string>Left</string>
         </property>
        </widget>
       </item>
       <item>
        <widget class="QLabel" name="label_3">
         <property name="text">
          <string>Right</string>
         </property>
        </widget>
       </item>
      </layout>
     </item>
    </layout>
   </item>
  </layout>
 </widget>
</ui>