图形视图(20)：【类】QGraphicsLayout[官翻]

QGraphicsLayout 类

QGraphicsLayout类为图形视图中的所有布局提供了基类。

Header:	#include < QGraphicsLayout>
qmake:	QT += widgets
Inherits:	QGraphicsLayoutItem
Inherited By:	QGraphicsAnchorLayout, QGraphicsGridLayout, QGraphicsLinearLayout
Since:	Qt 4.4

详述

QGraphicsLayout是一个抽象类，它定义了一个虚拟API，用于为QGraphicsWidget安排子QGraphicsLayoutItem对象。QGraphicsWidget通过QGraphicsWidget::setLayout()将责任分配给QGraphicsLayout。当小部件被调整大小时，布局将自动安排小部件的子部件。QGraphicsLayout继承QGraphicsLayoutItem，因此，它可以被任何布局管理，包括它自己的子类。

编写自定义布局

可以使用QGraphicsLayout作为基础来编写你自己的自定义布局(例如，flowlayout)，但更常见的是使用它的子类来代替- QGraphicsLinearLayout或QGraphicsGridLayout。当创建一个自定义布局时，以下函数必须被重新实现:

Function	Description
QGraphicsLayoutItem::setGeometry()	当布局的几何图形设置完成时通知您。您可以在重新实现该函数时将几何图形存储在您自己的布局类中。
QGraphicsLayoutItem::sizeHint()	返回布局的大小提示。
QGraphicsLayout::count()	返回布局中项目的数量。
QGraphicsLayout::itemAt()	返回指向布局中某项的指针。
QGraphicsLayout::removeAt()	从布局中删除项目而不销毁它。

激活布局

当布局的几何形状发生变化时，QGraphicsLayout通过调用setGeometry()对每个项重新排列所有托管项。这种重新安排称为激活布局。

QGraphicsLayout更新自己的几何图形，以匹配它管理的QGraphicsLayoutItem的contentsRect()。因此，当小部件调整大小时，它将自动重新排列所有项。QGraphicsLayout缓存所有托管项的大小，以避免过于频繁地调用setGeometry()。

注意:QGraphicsLayout与被分配给它的小部件的contentsRect()(而不是布局)具有相同的几何形状。

隐式激活布局

可以使用以下两种方式之一来隐式激活布局:通过调用activate()或调用invalidate()。调用activate()会立即激活布局。相反，调用invalidate()会被延迟，因为它会向托管小部件提交一个LayoutRequest事件。由于事件压缩，activate()只会在控制返回到事件循环后调用一次。这被称为使布局无效。使布局无效也会使任何缓存的信息无效。同样，invalidate()函数也是虚函数。因此，通过重新实现这个函数，可以在QGraphicsLayout的子类中使自己的缓存失效。

事件处理

QGraphicsLayout通过virtual widgetEvent()事件处理程序监听它管理的小部件的事件。当布局分配给小部件时，交付给小部件的所有事件首先由widgetEvent()处理。这允许布局能够感知小部件上的任何相关状态变化，比如可见性变化或布局方向变化。

边距处理

QGraphicsLayout的边距可以通过重新实现setContentsMargins()和getContentsMargins()来修改。

公共函数

构造和析构

1. QGraphicsLayout(QGraphicsLayoutItem *parent = nullptr)
2. virtual ~QGraphicsLayout()

激活

1. void activate()
2. virtual void invalidate()
3. bool isActivated() const

类似容器

1. virtual int count() const = 0
2. virtual QGraphicsLayoutItem * itemAt(int i) const = 0
3. virtual void removeAt(int index) = 0

边距

1. virtual void getContentsMargins(qreal *left, qreal *top, qreal *right, qreal *bottom) const override
2. void setContentsMargins(qreal left, qreal top, qreal right, qreal bottom)

事件

1. virtual void widgetEvent(QEvent *e)

重写的公共函数

1. virtual void getContentsMargins(qreal *left, qreal *top, qreal *right, qreal *bottom) const override
2. virtual void updateGeometry() override

受保护的函数

1. void addChildLayoutItem(QGraphicsLayoutItem *layoutItem)