QGraphicsAnchorLayout 类

成员函数文档

QGraphicsAnchorLayout::QGraphicsAnchorLayout(QGraphicsLayoutItem *parent = nullptr)

构建一个 QGraphicsAnchorLayout 实例。将 parent 传递给 QGraphicsLayout 的构造函数。

[virtual noexcept] QGraphicsAnchorLayout::~QGraphicsAnchorLayout()

销毁 QGraphicsAnchorLayout 对象。

QGraphicsAnchor *QGraphicsAnchorLayout::addAnchor(QGraphicsLayoutItem *firstItem, Qt::AnchorPoint firstEdge, QGraphicsLayoutItem *secondItem, Qt::AnchorPoint secondEdge)

在项目 firstItem 的 firstEdge 边缘和项目 secondItem 的 secondEdge 边缘之间创建一个锚点。锚点的间距从样式获取。布局边和项目边的锚点将具有大小为 0。如果两个边之间已经存在一个锚点，则新的锚点将替换旧的锚点。

firstItem 和 secondItem 如果不是布局的一部分，则会自动添加到布局中。这意味着 count() 可以增加多达 2。

锚点获取的间距取决于锚点的类型。例如，一个项目的右侧边缘到另一个项目的左侧边缘（或反之亦然）的锚点将使用默认的水平间距。相同的行为中国 North 到 Top 的锚点（但它们将使用默认的垂直间距）。对于所有其他锚点组合，间距将为 0。所有锚点函数都将遵循此规则。

还可以使用 QGraphicsAnchor::setSpacing() 方法手动设置间距。

当 firstItem 或 secondItem 是布局的祖先时，调用此函数会有未定义的行为。

另请参阅addAnchors() 和 addCornerAnchors()。

void QGraphicsAnchorLayout::addAnchors(QGraphicsLayoutItem *firstItem, QGraphicsLayoutItem *secondItem, Qt::Orientations orientations = Qt::Horizontal | Qt::Vertical)

将 firstItem 的两个或四个边与 secondItem 的对应边锚定，使得 firstItem 在 orientations 指定的维度上与 secondItem 具有相同的大小。

例如，以下示例将两个项目的左右边缘锚定以匹配它们的宽度

layout->addAnchor(b, Qt::AnchorLeft, c, Qt::AnchorLeft);
layout->addAnchor(b, Qt::AnchorRight, c, Qt::AnchorRight);

这也可以使用以下代码实现

layout->addAnchors(b, c, Qt::Horizontal);

另请参阅addAnchor() 和 addCornerAnchors()。

void QGraphicsAnchorLayout::addCornerAnchors(QGraphicsLayoutItem *firstItem, Qt::Corner firstCorner, QGraphicsLayoutItem *secondItem, Qt::Corner secondCorner)

在由角落 firstCorner 和 secondCorner 指定的 firstItem 和 secondItem 之间创建两个锚点，一个用于水平边缘，另一个用于垂直边缘。

这是一个便利函数，因为角锚定可以表达为锚定两个边缘。例如

layout->addAnchor(a, Qt::AnchorTop, layout, Qt::AnchorTop);
layout->addAnchor(a, Qt::AnchorLeft, layout, Qt::AnchorLeft);

这也可以通过以下代码行实现

layout->addCornerAnchors(a, Qt::TopLeftCorner, layout, Qt::TopLeftCorner);

如果已存在边缘对之间的锚点，它将被本函数指定的锚点替换。

firstItem 和 secondItem 如果不是布局的一部分，则会自动添加到布局中。这意味着 count() 可以增加多达 2。

另请参阅 addAnchor() 和 addAnchors.

QGraphicsAnchor *QGraphicsAnchorLayout::anchor(QGraphicsLayoutItem *firstItem, Qt::AnchorPoint firstEdge, QGraphicsLayoutItem *secondItem, Qt::AnchorPoint secondEdge)

返回由 firstItem 和 firstEdge 以及 secondItem 和 secondEdge 定义的锚点之间的锚。如果没有这样的锚点，函数将返回0。

[重写虚拟] int QGraphicsAnchorLayout::count() const

重写: QGraphicsLayout::count() const.

qreal QGraphicsAnchorLayout::horizontalSpacing() const

返回锚布局的默认水平间隔。

另请参阅 verticalSpacing() 和 setHorizontalSpacing.

[重写虚拟] void QGraphicsAnchorLayout::invalidate()

重写: QGraphicsLayout::invalidate().

[重写虚拟] QGraphicsLayoutItem *QGraphicsAnchorLayout::itemAt(int index) const

重写: QGraphicsLayout::itemAt(int i) const.

[重写虚拟] void QGraphicsAnchorLayout::removeAt(int index)

重写: QGraphicsLayout::removeAt(int index).

移除位于 index 的布局项而不销毁它。项目的所有权转移给调用者。

移除项还会移除与其关联的所有锚点。

另请参阅 itemAt() 和 count.

[重写虚拟] void QGraphicsAnchorLayout::setGeometry(const QRectF &geom)

重写: QGraphicsLayoutItem::setGeometry(const QRectF &rect).

void QGraphicsAnchorLayout::setHorizontalSpacing(qreal spacing)

将锚布局的默认水平间隔设置为 spacing。

另请参阅 horizontalSpacing(), setVerticalSpacing(), 和 setSpacing.

void QGraphicsAnchorLayout::setSpacing(qreal spacing)

设置锚布局的默认水平和默认垂直间距为spacing。

如果一个项目没有与锚相关联的间距，它将使用默认间距。

QGraphicsAnchorLayout不支持负间距。设置负值将取消之前的间距，并使布局使用当前小部件风格的间距。

另请参阅setHorizontalSpacing() 和 setVerticalSpacing()。

void QGraphicsAnchorLayout::setVerticalSpacing(qreal spacing)

将锚布局的默认垂直间距设置为spacing。

另请参阅verticalSpacing()，setHorizontalSpacing() 及 setSpacing()。

[覆盖虚保护] QSizeF QGraphicsAnchorLayout::sizeHint(Qt::SizeHint which, const QSizeF &constraint = QSizeF()) const

重新实现了：QGraphicsLayoutItem::sizeHint(Qt::SizeHint which, const QSizeF &constraint) const.

qreal QGraphicsAnchorLayout::verticalSpacing() const

返回锚布局的默认垂直间距。

另请参阅horizontalSpacing() 和 setVerticalSpacing()。