QGraphicsLayout 类

成员函数文档

QGraphicsLayout::QGraphicsLayout(QGraphicsLayoutItem *parent = nullptr)

构造一个 QGraphicsLayout 对象。

parent 被传递给QGraphicsLayoutItem 的构造函数，并将 QGraphicsLayoutItem 的 isLayout 参数设置为 true。

如果 parent 是 QGraphicsWidget，则布局将安装在该小部件上。（注意，安装布局将删除已安装的旧布局。）

[虚，noexcept] QGraphicsLayout::~QGraphicsLayout()

销毁 QGraphicsLayout 对象。

void QGraphicsLayout::activate()

激活布局，导致布局中的所有项立即重新排列。此函数基于调用 count() 和 itemAt()，然后按顺序对所有项目调用 setGeometry()。激活时，布局将调整其几何形状以匹配其父项的 contentsRect。然后父项将使任何自己的布局无效。

如果按顺序或递归调用，例如，通过响应调整大小而进行排列的小部件之一，此函数将不做任何事情。

请注意，布局可自由使用几何缓存来优化此过程。在调用 activate() 之前，您可以调用 invalidate() 强制使任何此类缓存无效。

另请参阅invalidate。

[保护的] void QGraphicsLayout::addChildLayoutItem(QGraphicsLayoutItem *layoutItem)

此函数是提供给自定义布局的方便函数，将遍历布局中的所有项，并将它们的图形项目重新父子化到布局最近的上 QGraphicsWidget 祖先。

如果 layoutItem 已经在不同的布局中，它将从该布局中删除。

如果自定义布局想要特殊的行为，可以忽略使用此函数并实现自己的行为。

另请参阅graphicsItem。

[纯虚] int QGraphicsLayout::count() const

必须在 QGraphicsLayout 的子类中重新实现此纯虚函数以返回布局中的项数。

子类可以自由决定如何存储项。

另请参阅 itemAt() 和 removeAt()。

[重写虚函数] void QGraphicsLayout::getContentsMargins(qreal *left, qreal *top, qreal *right, qreal *bottom) const

重写：QGraphicsLayoutItem::getContentsMargins(qreal *left, qreal *top, qreal *right, qreal *bottom) const。

[虚函数] void QGraphicsLayout::invalidate()

清除布局中的任何缓存的几何形状和尺寸提示信息，并向管理父 QGraphicsLayoutItem 发送 LayoutRequest 事件。

另请参阅 activate() 和 setGeometry()。

bool QGraphicsLayout::isActivated() const

如果布局目前正在激活中，返回 true；否则，返回 false。如果布局正在激活，这意味着它目前正在重新排列其项目（即，已调用 activate() 函数，并且尚未返回）。

另请参阅 activate() 和 invalidate()。

[纯虚函数] QGraphicsLayoutItem *QGraphicsLayout::itemAt(int i) const

该纯虚函数必须在 QGraphicsLayout 的子类中重写，以返回索引 i 的项目指针。重写可以假设 i 是有效的（即，它遵守 count()) 的值）。与 count() 一起，它作为一种遍历布局中所有项目的方法。

子类可以自行决定如何存储项目，并且视觉排列不需要通过此函数反映。

另请参阅 count() 和 removeAt()。

[纯虚函数] void QGraphicsLayout::removeAt(int index)

该纯虚函数必须在 QGraphicsLayout 的子类中重写，以删除索引 index 的项目。重写可以假设 index 是有效的（即，它遵守 count()) 的值）。

实现必须确保被删除的项目的前一个布局项不指向此布局，因为该项目被认为是从布局层次结构中删除的。

如果我们建议在应用程序之间重用布局，则建议布局删除项目，但图形视图框架不依赖于这一点。

子类可以自由决定如何存储项。

另请参阅 itemAt() 和 count()。

void QGraphicsLayout::setContentsMargins(qreal left, qreal top, qreal right, qreal bottom)

设置内容边距为 left，top，right 和 bottom。顶级布局的默认内容边距取决于样式（通过查询 QStyle::PM_LayoutLeftMargin、QStyle::PM_LayoutTopMargin、QStyle::PM_LayoutRightMargin 和 QStyle::PM_LayoutBottomMargin 的像素度量）。

对于子布局，默认边距为 0。

更改内容边距将自动使布局无效。

另请参阅invalidate。

[覆盖虚函数] void QGraphicsLayout::updateGeometry()

重新实现：QGraphicsLayoutItem::updateGeometry().

[虚函数] void QGraphicsLayout::widgetEvent(QEvent *e)

此虚拟事件处理程序接收所有管理小部件的事件。 QGraphicsLayout 使用此事件处理程序来监听与布局相关的事件，例如几何变化、布局变化或布局方向变化。

e 是事件的指针。

您可以重新实现此事件处理程序来跟踪您的自定义布局的类似事件。

另请参阅QGraphicsWidget::event() 和 QGraphicsItem::sceneEvent().