C++界面开发框架Qt 6.x入门指南 - Qt Widget布局管理（四）

Qt布局系统提供了一种简单而强大的方式来自动排列小部件内的子小部件，以确保它们充分利用可用空间。

Qt技术交流群：166830288      欢迎一起进群讨论

点击获取Qt组件下载

手动布局

如果您正在制作独一无二的特殊布局，还可以制作如前几篇文章所述的自定义小部件，重新实现 QWidget::resizeEvent()来计算所需的尺寸分布并在每个子集上调用setGeometry()。

当需要重新计算布局时，小部件将获得QEvent::LayoutRequest 类型的事件，重新实现 QWidget::event() 来处理 QEvent::LayoutRequest 事件。

如何编写自定义布局管理器

手动布局的替代方法是通过继承QLayout来编写自己的布局管理器，边框布局和流布局示例展示了如何执行此操作。

这里我们详细介绍一个例子。CardLayout 类的灵感来自同名的 Java 布局管理器，它将项目（小部件或嵌套布局）放在彼此的顶部，每个项目由 QLayout::spacing()偏移。

要编写自己的布局类，您必须定义以下内容：

• 存储布局处理的项目的数据结构，每个项目都是一个QLayoutItem，我们将在本例中使用QList 。
• addItem()，如何将项目添加到布局。
• setGeometry()，如何执行布局。
• sizeHint()，布局的首选大小。
• itemAt()，如何迭代布局。
• takeAt()，如何从布局中删除项目。

在大多数情况下，您还将实现 minimumSize()。

Header File (card.h)

#ifndef CARD_H
#define CARD_H

#include <QtWidgets>
#include <QList>

class CardLayout : public QLayout
{
public:
CardLayout(int spacing): QLayout()
{ setSpacing(spacing); }
CardLayout(int spacing, QWidget *parent): QLayout(parent)
{ setSpacing(spacing); }
~CardLayout();

void addItem(QLayoutItem *item) override;
QSize sizeHint() const override;
QSize minimumSize() const override;
int count() const override;
QLayoutItem *itemAt(int) const override;
QLayoutItem *takeAt(int) override;
void setGeometry(const QRect &rect) override;

private:
QList<QLayoutItem *> m_items;
};
#endif

Implementation File (card.cpp)

//#include "card.h"

首先我们定义 count() 来获取列表中的项目数。

int CardLayout::count() const
{
// QList::size() returns the number of QLayoutItems in m_items
return m_items.size();
}

然后我们定义了两个遍历布局的函数：itemAt() 和 takeAt()。 布局系统内部使用这些函数来处理小部件的删除，它们也可供应用程序程序员使用。

itemAt() 返回给定索引处的项目，takeAt() 删除给定索引处的项目，并将其返回。 在这种情况下，我们使用列表索引作为布局索引。 在我们有更复杂的数据结构的其他情况下，可能需要花费更多的精力来定义项目的线性顺序。

QLayoutItem *CardLayout::itemAt(int idx) const
{
// QList::value() performs index checking, and returns nullptr if we are
// outside the valid range
return m_items.value(idx);
}

QLayoutItem *CardLayout::takeAt(int idx)
{
// QList::take does not do index checking
return idx >= 0 && idx < m_items.size() ? m_items.takeAt(idx) : 0;
}

addItem() 实现布局项的默认放置策略，必须实现此功能。 它由 QLayout::add() 使用，由将布局作为父级的 QLayout构造函数使用。如果您的布局具有需要参数的高级放置选项，则必须提供额外的访问函数，例如 QGridLayout::addItem()、QGridLayout::addWidget()和 QGridLayout::addLayout() 的跨行和跨列重载。

void CardLayout::addItem(QLayoutItem *item)
{
m_items.append(item);
}

布局接管添加的项目的责任，由于QLayoutItem不继承 QObject，我们必须手动删除项目。 在析构函数中，使用 takeAt() 从列表中删除每个项目，然后将其删除。

CardLayout::~CardLayout()
{
QLayoutItem *item;
while ((item = takeAt(0)))
delete item;
}

setGeometry() 函数实际上执行布局，作为参数提供的矩形不包括 margin()。 如果相关，请使用 spacing() 作为项目之间的距离。

void CardLayout::setGeometry(const QRect &r)
{
QLayout::setGeometry(r);

if (m_items.size() == 0)
return;

int w = r.width() - (m_items.count() - 1) * spacing();
int h = r.height() - (m_items.count() - 1) * spacing();
int i = 0;
while (i < m_items.size()) {
QLayoutItem *o = m_items.at(i);
QRect geom(r.x() + i * spacing(), r.y() + i * spacing(), w, h);
o->setGeometry(geom);
++i;
}
}

sizeHint() 和 minimumSize() 在实现上通常非常相似，两个函数返回的尺寸都应该包括spacing()，但不包括margin()。

QSize CardLayout::sizeHint() const
{
QSize s(0, 0);
int n = m_items.count();
if (n > 0)
s = QSize(100, 70); //start with a nice default size
int i = 0;
while (i < n) {
QLayoutItem *o = m_items.at(i);
s = s.expandedTo(o->sizeHint());
++i;
}
return s + n * QSize(spacing(), spacing());
}

QSize CardLayout::minimumSize() const
{
QSize s(0, 0);
int n = m_items.count();
int i = 0;
while (i < n) {
QLayoutItem *o = m_items.at(i);
s = s.expandedTo(o->minimumSize());
++i;
}
return s + n * QSize(spacing(), spacing());
}

Qt商用组件推荐

• QtitanRibbon - Ribbon UI组件：是一款遵循Microsoft Ribbon UI Paradigm for Qt技术的Ribbon UI组件，QtitanRibbon致力于为Windows、Linux和Mac OS X提供功能完整的Ribbon组件。
• QtitanChart - Qt类图表组件：是一个C ++库，代表一组控件，这些控件使您可以快速地为应用程序提供漂亮而丰富的图表。
• QtitanDataGrid - Qt网格组件：提供了一套完整的标准 QTableView 函数和传统组件无法实现的独特功能。使您能够将不同来源的各类数据加载到一个快速、灵活且功能强大的可编辑网格中，支持排序、分组、报告、创建带状列、拖放按钮和许多其他方便的功能。
• QtitanNavigation：QtitanNavigationDesignUI 组件是一组 GUI 控件，它实现了菜单、导航框、命令栏等导航界面，并让您以更少的滚动和点击次数有效地查看所有实体（工作区、网格或其他项目）。
• QtitanDocking：允许您像 Visual Studio 一样为您的伟大应用程序配备可停靠面板和可停靠工具栏。黑色、白色、蓝色调色板完全支持 Visual Studio 2019 主题！

---

Qt技术交流群：166830288      欢迎一起进群讨论

更多Qt产品教程、下载、正版授权资讯，请点击获取