Qt布局系統提供了一種簡單而強大的方式來自動排列小部件內的子小部件，以確保它們充分利用可用空間。

Qt技術交流群：166830288      歡迎一起進群討論

手動布局

如果您正在制作獨一無二的特殊布局，還可以制作如前幾篇文章所述的自定義小部件，重新實現 ()來計算所需的尺寸分布并在每個子集上調用()。

當需要重新計算布局時，小部件將獲得 類型的事件，重新實現 () 來處理 事件。

如何編寫自定義布局管理器

手動布局的替代方法是通過繼承來編寫自己的布局管理器，邊框布局和流布局示例展示了如何執行此操作。

這里我們詳細介紹一個例子。CardLayout 類的靈感來自同名的 Java 布局管理器，它將項目（小部件或嵌套布局）放在彼此的頂部，每個項目由 ()偏移。

要編寫自己的布局類，您必須定義以下內容：

• 存儲布局處理的項目的數據結構，每個項目都是一個，我們將在本例中使用 。
• ()，如何將項目添加到布局。
• ()，如何執行布局。
• ()，布局的首選大小。
• ()，如何迭代布局。
• ()，如何從布局中刪除項目。

在大多數情況下，您還將實現 ()。

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() 使用，由將布局作為父級的 構造函數使用。如果您的布局具有需要參數的高級放置選項，則必須提供額外的訪問函數，例如 ()、()和 () 的跨行和跨列重載。

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

布局接管添加的項目的責任，由于不繼承 ，我們必須手動刪除項目。 在析構函數中，使用 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      歡迎一起進群討論