QGraphicsLayoutItem 类

成员函数文档

QGraphicsLayoutItem::QGraphicsLayoutItem(QGraphicsLayoutItem *parent = nullptr, bool isLayout = false)

创建 QGraphicsLayoutItem 对象。 parent 变为对象的父对象。如果 isLayout 为 true，该项是一个布局，否则 isLayout 为 false。

[虚拟非异常] QGraphicsLayoutItem::~QGraphicsLayoutItem()

销毁 QGraphicsLayoutItem 对象。

QRectF QGraphicsLayoutItem::contentsRect() const

返回本地坐标中的内容矩形。

内容矩形定义了相关布局在排列子项时使用的子矩形。此函数是一个便利函数，通过调整项的 geometry() 来调整其内容边距。注意，getContentsMargins() 是一个虚拟函数，您可以重新实现它以返回项的内容边距。

另见getContentsMargins() 和 geometry。

QSizeF QGraphicsLayoutItem::effectiveSizeHint(Qt::SizeHint which, const QSizeF &constraint = QSizeF()) const

返回此 QGraphicsLayoutItem 的有效大小提示。

which 是需要的大小提示。 constraint 是一个可选参数，当计算有效大小提示时定义了一个特殊情况。默认情况下，constraint 是 QSizeF(-1, -1)，表示没有对大小提示的约束。

如果您想根据给定的宽度或高度指定小部件的大小提示，您可以通过提供固定维度来做到这一点，即 约束。这对于只能垂直或水平扩展的小部件很有用，需要将它们的宽度或高度设置为特定值。

例如，一个能够适应200像素列宽的文本段落项可能会垂直扩展。您可以将 QSizeF(200, -1) 作为约束传递，以获取合适的最小、首选和最大高度。

您可以通过重新实现 sizeHint() 在一个 QGraphicsLayoutItem 子类中，或者通过调用以下函数之一来调整有效的尺寸提示：setMinimumSize()，setPreferredSize 或 setMaximumSize()（或两者的组合）。

此函数为每个大小提示缓存，并保证仅在 which 的每个值上调用一次 sizeHint() - 除非未指定 约束 并且调用了 updateGeometry()。

另请参阅 sizeHint()。

QRectF QGraphicsLayoutItem::geometry() const

以 QRectF 形式返回项的几何形状（例如，位置和大小）。此函数与 QRectF(pos(), size()) 相等。

另请参阅 setGeometry()。

[虚拟] void QGraphicsLayoutItem::getContentsMargins(qreal *left, qreal *top, qreal *right, qreal *bottom) const

此虚拟函数为这个 QGraphicsLayoutItem 提供了左侧、上侧、右侧和下侧的内容边距。默认实现假定所有内容边距都是0。参数指向存储在 qreals 中的值。如果任一指针是 nullptr，则不会更新该值。

另请参阅 QGraphicsWidget::setContentsMargins。

QGraphicsItem *QGraphicsLayoutItem::graphicsItem() const

返回此布局项表示的 QGraphicsItem。对于 QGraphicsWidget，它将返回自身。对于自定义项，它可能返回一个聚合值。

另请参阅 setGraphicsItem()。

[虚拟，自6.0以来] bool QGraphicsLayoutItem::isEmpty() const

如果此项为空，即它没有内容并且不应占用任何空间，则返回 true。

默认实现返回 true，如果项已被隐藏，除非其 size policy 中的 retainSizeWhenHidden 设置为 true。

此函数从 Qt 6.0 开始引入。

另请参阅 sizePolicy。

bool QGraphicsLayoutItem::isLayout() const

如果这个 QGraphicsLayoutItem 是一个布局（例如，它是由一个包含其他 QGraphicsLayoutItem 对象的对象继承而来），则返回 true；否则返回 false。

另请参阅 QGraphicsLayout。

qreal QGraphicsLayoutItem::maximumHeight() const

返回最大高度。

另请参阅 setMaximumHeight()，setMaximumSize() 和 maximumSize。

QSizeF QGraphicsLayoutItem::maximumSize() const

返回最大尺寸。

另请参阅 setMaximumSize()，minimumSize()，preferredSize()，Qt::MaximumSize 和 sizeHint。

qreal QGraphicsLayoutItem::maximumWidth() const

返回最大宽度。

另请参阅 setMaximumWidth()，setMaximumSize() 和 maximumSize。

qreal QGraphicsLayoutItem::minimumHeight() const

返回最小高度。

另请参阅 setMinimumHeight()，setMinimumSize() 和 minimumSize。

QSizeF QGraphicsLayoutItem::minimumSize() const

返回最小尺寸。

另请参阅 setMinimumSize()，preferredSize()，maximumSize()，Qt::MinimumSize 和 sizeHint。

qreal QGraphicsLayoutItem::minimumWidth() const

返回最小宽度。

另请参阅 setMinimumWidth()，setMinimumSize() 和 minimumSize。

bool QGraphicsLayoutItem::ownedByLayout() const

返回布局是否应在析构函数中删除此项目。如果是 true，则布局会删除它。如果是 false，则假定另一个对象拥有它，布局不会删除此项目。

如果项目同时继承 QGraphicsItem 和 QGraphicsLayoutItem（例如 QGraphicsWidget），则项目实际是两个所有权层次结构的一部分。此属性告诉布局在销毁时对其子项目应做什么。在 QGraphicsWidget 的例子中，当布局被删除时不受青睐删除其子项（因为它们也是图形项层次结构的一部分）。

默认情况下，此值在QGraphicsLayoutItem中初始化为false，但被QGraphicsLayout重写以返回true。这是因为QGraphicsLayout通常不是QGraphicsItem层次结构的一部分，因此布局的父级应该删除它。子类可能通过调用setOwnedByLayout(true)来重写此默认行为。

另请参阅setOwnedByLayout。

QGraphicsLayoutItem *QGraphicsLayoutItem::parentLayoutItem() const

返回此QGraphicsLayoutItem的父级，如果没有父级或父级未从QGraphicsLayoutItem继承，则返回nullptr（QGraphicsLayoutItem通常与QObject-derived classes一起通过多重继承使用）。

另请参阅setParentLayoutItem。

qreal QGraphicsLayoutItem::preferredHeight() const

返回首选高度。

另请参阅setPreferredHeight、setPreferredSize和preferredSize。

QSizeF QGraphicsLayoutItem::preferredSize() const

返回首选大小。

另请参阅setPreferredSize、minimumSize、maximumSize、Qt::PreferredSize和sizeHint。

qreal QGraphicsLayoutItem::preferredWidth() const

返回首选宽度。

另请参阅setPreferredWidth、setPreferredSize和preferredSize。

[虚函数] void QGraphicsLayoutItem::setGeometry(const QRectF &rect)

此虚拟函数将QGraphicsLayoutItem的几何形状设置到rect，该矩形以父级坐标为准（例如，rect的左上角与项目在父级坐标中的位置相等）。

必须在QGraphicsLayoutItem的子类中重新实现此函数以接收几何形状更新。布局将在进行重新排列时调用此函数。

如果rect超出了minimumSize和maximumSize的边界，则将其调整为最接近的大小，使得它位于有效边界内。

另请参阅geometry。

[保护函数] void QGraphicsLayoutItem::setGraphicsItem(QGraphicsItem *item)

如果 QGraphicsLayoutItem 表示一个 QGraphicsItem，并且它想利用 QGraphicsLayout 的自动重新父化功能，则应设置此值。请注意，如果您删除了 item 但没有删除布局项，您需要负责调用 setGraphicsItem(nullptr) 以避免出现悬挂指针。

另请参阅 graphicsItem。

void QGraphicsLayoutItem::setMaximumHeight(qreal height)

设置最大高度为 height。

另请参阅 maximumHeight()，setMaximumSize() 和 maximumSize。

void QGraphicsLayoutItem::setMaximumSize(const QSizeF &size)

设置最大尺寸为 size。此属性覆盖了 sizeHint() 对 Qt::MaximumSize 的设置，并保证 effectiveSizeHint() 从不返回大于 size 的大小。为了取消最大尺寸设置，请使用无效的尺寸。

另请参阅 maximumSize()，minimumSize()，preferredSize()，Qt::MaximumSize 和 sizeHint。

void QGraphicsLayoutItem::setMaximumSize(qreal w, qreal h)

此便捷函数相当于调用 setMaximumSize(QSizeF(w, h))。

另请参阅 maximumSize()，setMinimumSize()，setPreferredSize() 和 sizeHint。

void QGraphicsLayoutItem::setMaximumWidth(qreal width)

设置最大宽度为 width。

另请参阅 maximumWidth()，setMaximumSize() 和 maximumSize。

void QGraphicsLayoutItem::setMinimumHeight(qreal height)

设置最小高度为 height。

另请参阅 minimumHeight()，setMinimumSize() 和 minimumSize。

void QGraphicsLayoutItem::setMinimumSize(const QSizeF &size)

设置最小尺寸为 size。此属性覆盖了 sizeHint() 对 Qt::MinimumSize 的设置，并保证 effectiveSizeHint() 从不返回小于 size 的大小。为了取消最小尺寸设置，请使用无效的尺寸。

另请参阅 minimumSize()，maximumSize()，preferredSize()，Qt::MinimumSize，sizeHint()，setMinimumWidth() 和 setMinimumHeight()。

void QGraphicsLayoutItem::setMinimumSize(qreal w, qreal h)

此便捷函数等价于调用 setMinimumSize(QSizeF(w, h))。

另请参阅 minimumSize()，setMaximumSize()，setPreferredSize() 和 sizeHint()。

void QGraphicsLayoutItem::setMinimumWidth(qreal width)

设置最小宽度为 width。

另请参阅 minimumWidth()，setMinimumSize() 和 minimumSize()。

[protected] void QGraphicsLayoutItem::setOwnedByLayout(bool ownership)

设置布局是否应在析构函数中删除此项。要使布局能够删除它，ownership 必须为 true。

另请参阅 ownedByLayout()。

void QGraphicsLayoutItem::setParentLayoutItem(QGraphicsLayoutItem *parent)

将此 QGraphicsLayoutItem 的父级设置为 parent。

另请参阅 parentLayoutItem()。

void QGraphicsLayoutItem::setPreferredHeight(qreal height)

设置首选高度为 height。

另请参阅 preferredHeight()，preferredWidth()，setPreferredSize() 和 preferredSize()。

void QGraphicsLayoutItem::setPreferredSize(const QSizeF &size)

将首选大小设置为 size。此属性覆盖了 sizeHint() 对于 Qt::PreferredSize 的值，并提供给 effectiveSizeHint 的默认值。要取消设置首选大小，请使用一个无效的大小。

另请参阅 preferredSize()，minimumSize()，maximumSize()，Qt::PreferredSize 和 sizeHint()。

void QGraphicsLayoutItem::setPreferredSize(qreal w, qreal h)

此便捷函数等价于调用 setPreferredSize(QSizeF(w, h))。

另请参阅 preferredSize()，setMaximumSize()，setMinimumSize()，以及sizeHint()。

void QGraphicsLayoutItem::setPreferredWidth(qreal 宽度)

将首选宽度设置为宽度。

另请参阅 preferredWidth()，preferredHeight()，setPreferredSize()，以及preferredSize()。

void QGraphicsLayoutItem::setSizePolicy(const QSizePolicy &策略)

设置大小策略为策略。大小策略描述了项目如何在布局中按照水平方向和垂直方向进行扩展。

QGraphicsLayoutItem的默认大小策略是（QSizePolicy::Fixed，QSizePolicy::Fixed，QSizePolicy::DefaultType），但子类通常会更改默认设置。例如，QGraphicsWidget的默认设置是（《a href="qsizepolicy.html#Policy-enum" translate="no">QSizePolicy::Preferred，QSizePolicy::Preferred，QSizePolicy::DefaultType）。

另请参阅 sizePolicy()以及QWidget::sizePolicy()。

void QGraphicsLayoutItem::setSizePolicy(QSizePolicy::Policy hPolicy，QSizePolicy::Policy vPolicy，QSizePolicy::ControlType controlType = QSizePolicy::DefaultType)

这是一个重载函数。

此函数与调用setSizePolicy（QSizePolicy（水平策略，垂直策略，控件类型））等价。

另请参阅 sizePolicy()以及QWidget::sizePolicy()。

[纯虚保护] QSizeF QGraphicsLayoutItem::sizeHint(Qt::SizeHint which，const QSizeF &constraint = QSizeF()) const

此纯虚函数返回QGraphicsLayoutItem的which的大小提示，使用约束的宽度和高度来约束输出。

在QGraphicsLayoutItem的子类中重写此函数，以提供项目所需的大小提示。

另请参阅 effectiveSizeHint()。

QSizePolicy QGraphicsLayoutItem::sizePolicy() const

返回当前大小策略。

另请参阅 setSizePolicy()以及QWidget::sizePolicy()。

[虚函数] void QGraphicsLayoutItem::updateGeometry()

此虚函数丢弃任何缓存的尺寸提示信息。每当您更改sizeHint()函数的返回值时，您都应调用此函数。子类在重写此函数时必须始终调用基类实现。

另请参阅 effectiveSizeHint()。