QGraphicsLayout Class

Dokumentation der Mitgliedsfunktionen

QGraphicsLayout::QGraphicsLayout(QGraphicsLayoutItem *parent = nullptr)

Konstruiert ein QGraphicsLayout-Objekt.

parent wird an den Konstruktor von QGraphicsLayoutItem übergeben und das Argument isLayout von QGraphicsLayoutItem wird auf true gesetzt.

Wenn parent ein QGraphicsWidget ist, wird das Layout auf diesem Widget installiert. (Beachten Sie, dass bei der Installation eines Layouts das alte Layout gelöscht wird).

[virtual noexcept] QGraphicsLayout::~QGraphicsLayout()

Zerstört das Objekt QGraphicsLayout.

void QGraphicsLayout::activate()

Aktiviert das Layout, wodurch alle Elemente im Layout sofort neu angeordnet werden. Diese Funktion basiert auf dem Aufruf von count() und itemAt() und dem anschließenden Aufruf von setGeometry() für alle Elemente nacheinander. Wenn sie aktiviert wird, passt das Layout seine Geometrie an die contentsRect() des Elternteils an. Das übergeordnete Element macht dann alle eigenen Layouts ungültig.

Wird diese Funktion nacheinander oder rekursiv aufgerufen, z. B. von einem der angeordneten Elemente als Reaktion auf eine Größenänderung, so bewirkt sie nichts.

Beachten Sie, dass es dem Layout freisteht, Geometrie-Caching zur Optimierung dieses Prozesses zu verwenden. Um einen solchen Cache zwangsweise zu deaktivieren, können Sie invalidate() aufrufen, bevor Sie activate() aufrufen.

Siehe auch invalidate().

[protected] void QGraphicsLayout::addChildLayoutItem(QGraphicsLayoutItem *layoutItem)

Diese Funktion ist eine Komfortfunktion, die für benutzerdefinierte Layouts zur Verfügung gestellt wird. Sie durchläuft alle Elemente im Layout und repariert ihre Grafikelemente auf den nächstgelegenen QGraphicsWidget Vorfahren des Layouts.

Wenn sich layoutItem bereits in einem anderen Layout befindet, wird es aus diesem Layout entfernt.

Wenn benutzerdefinierte Layouts ein spezielles Verhalten wünschen, können sie diese Funktion ignorieren und ihr eigenes Verhalten implementieren.

Siehe auch graphicsItem().

[pure virtual] int QGraphicsLayout::count() const

Diese rein virtuelle Funktion muss in einer Unterklasse von QGraphicsLayout reimplementiert werden, um die Anzahl der Elemente im Layout zurückzugeben.

Die Unterklasse kann frei entscheiden, wie die Elemente gespeichert werden sollen.

Siehe auch itemAt() und removeAt().

[override virtual] void QGraphicsLayout::getContentsMargins(qreal *left, qreal *top, qreal *right, qreal *bottom) const

Reimplements: QGraphicsLayoutItem::getContentsMargins(qreal *left, qreal *top, qreal *right, qreal *bottom) const.

[virtual] void QGraphicsLayout::invalidate()

Löscht alle zwischengespeicherten Geometrie- und Größenhinweise im Layout und sendet ein LayoutRequest Ereignis an das verwaltete übergeordnete Element QGraphicsLayoutItem.

Siehe auch activate() und setGeometry().

bool QGraphicsLayout::isActivated() const

Gibt true zurück, wenn das Layout gerade aktiviert wird; andernfalls wird false zurückgegeben. Wenn das Layout gerade aktiviert wird, bedeutet dies, dass es gerade dabei ist, seine Elemente neu anzuordnen (d. h., die Funktion activate() wurde aufgerufen und ist noch nicht zurückgekehrt).

Siehe auch activate() und invalidate().

[pure virtual] QGraphicsLayoutItem *QGraphicsLayout::itemAt(int i) const

Diese rein virtuelle Funktion muss in einer Unterklasse von QGraphicsLayout reimplementiert werden, um einen Zeiger auf das Element mit dem Index i zurückzugeben. Die Neuimplementierung kann davon ausgehen, dass i gültig ist (d. h., dass sie den Wert von count() respektiert). Zusammen mit count() wird sie als Mittel zur Iteration über alle Elemente in einem Layout bereitgestellt.

Die Unterklasse kann frei entscheiden, wie die Elemente gespeichert werden sollen, und die visuelle Anordnung muss nicht durch diese Funktion widergespiegelt werden.

Siehe auch count() und removeAt().

[pure virtual] void QGraphicsLayout::removeAt(int index)

Diese rein virtuelle Funktion muss in einer Unterklasse von QGraphicsLayout reimplementiert werden, um das Element unter index zu entfernen. Die Neuimplementierung kann davon ausgehen, dass index gültig ist (d. h. sie respektiert den Wert von count()).

Die Implementierung muss sicherstellen, dass parentLayoutItem() des entfernten Elements nicht auf dieses Layout verweist, da das Element als aus der Layouthierarchie entfernt betrachtet wird.

Wenn das Layout zwischen verschiedenen Anwendungen wiederverwendet werden soll, wird empfohlen, dass das Layout das Element löscht, aber das Graphics View Framework ist davon nicht abhängig.

Die Unterklasse kann frei entscheiden, wie sie die Elemente speichert.

Siehe auch itemAt() und count().

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

Setzt die Inhaltsränder auf left, top, right und bottom. Die Standard-Inhaltsränder für Toplevel-Layouts sind stilabhängig (durch Abfrage der PixelMetrik für QStyle::PM_LayoutLeftMargin, QStyle::PM_LayoutTopMargin, QStyle::PM_LayoutRightMargin und QStyle::PM_LayoutBottomMargin).

Für Sublayouts sind die Standardränder 0.

Eine Änderung der Inhaltsränder macht das Layout automatisch ungültig.

Siehe auch invalidate().

[override virtual] void QGraphicsLayout::updateGeometry()

Reimplements: QGraphicsLayoutItem::updateGeometry().

[virtual] void QGraphicsLayout::widgetEvent(QEvent *e)

Dieser virtuelle Ereignishandler empfängt alle Ereignisse für das verwaltete Widget. QGraphicsLayout verwendet diesen Ereignishandler, um auf layoutbezogene Ereignisse wie Geometrieänderungen, Layoutänderungen oder Änderungen der Layoutrichtung zu warten.

e ist ein Zeiger auf das Ereignis.

Sie können diesen Ereignishandler neu implementieren, um ähnliche Ereignisse für Ihr eigenes benutzerdefiniertes Layout zu verfolgen.

Siehe auch QGraphicsWidget::event() und QGraphicsItem::sceneEvent().