C++界面开发框架Qt 6.x入门级教程：Qt Widget- 布局管理（四）

本文主要为大家介绍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_itemsreturn 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 rangereturn m_items.value(idx);}QLayoutItem *CardLayout::takeAt(int idx){// QList::take does not do index checkingreturn 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 sizeint 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产品教程、下载、正版授权资讯，请点击获取

标签：

来源：慧都