QGraphicsLayout Class

Dokumentation der Mitgliedsfunktionen

QGraphicsLayout::QGraphicsLayout(QGraphicsLayoutItem *parent = nullptr)

Erstellt 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 durch die Installation eines Layouts das zuvor installierte Layout gelöscht wird.)

[virtual noexcept] QGraphicsLayout::~QGraphicsLayout()

Löscht das „ QGraphicsLayout “-Objekt.

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()` sowie dem anschließenden sequenziellen Aufruf von ` setGeometry()` für alle Elemente. Bei der Aktivierung passt das Layout seine Geometrie an die vom übergeordneten Element mit ` contentsRect()` festgelegte Geometrie an. Das übergeordnete Element macht daraufhin sein eigenes Layout ungültig.

Wird diese Funktion nacheinander oder rekursiv aufgerufen, z. B. von einem der angeordneten Elemente als Reaktion auf eine Größenänderung, führt sie keine Aktion aus.

Beachten Sie, dass das Layout zur Optimierung dieses Vorgangs Geometrie-Caching verwenden kann. Um einen solchen Cache zwangsweise zu ungültig zu machen, können Sie vor dem Aufruf von `activate()` die Funktion ` invalidate()` aufrufen.

Siehe auch invalidate().

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

Diese Funktion ist eine Hilfsfunktion für benutzerdefinierte Layouts. Sie durchläuft alle Elemente im Layout und ordnet deren Grafikelemente dem nächstgelegenen „ QGraphicsWidget “-Vorfahren des Layouts zu.

Befindet sich „ layoutItem “ bereits in einem anderen Layout, wird es aus diesem Layout entfernt.

Wenn benutzerdefinierte Layouts ein spezielles Verhalten erfordern, können sie die Verwendung dieser 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 “ neu implementiert 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

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

[virtual] void QGraphicsLayout::invalidate()

Löscht alle zwischengespeicherten Geometrie- und Größenhinweisinformationen 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. Wird das Layout gerade aktiviert, bedeutet dies, dass es gerade dabei ist, seine Elemente neu anzuordnen (d. h., die Funktion „ activate()“ wurde aufgerufen und hat noch keinen Rückgabewert geliefert).

Siehe auch activate() und invalidate().

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

Diese rein virtuelle Funktion muss in einer Unterklasse von ` QGraphicsLayout ` neu implementiert werden, um einen Zeiger auf das Element am Index ` i` zurückzugeben. Die Neuimplementierung kann davon ausgehen, dass ` i ` gültig ist (d. h., sie berücksichtigt den Wert von ` count()`). Zusammen mit ` count()` dient sie dazu, alle Elemente in einem Layout zu durchlaufen.

Die Unterklasse kann frei entscheiden, wie die Elemente gespeichert werden, und die visuelle Anordnung muss sich nicht in dieser Funktion widerspiegeln.

Siehe auch „ count “ () und „ removeAt “ ().

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

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

Die Implementierung muss sicherstellen, dass die Methode ` parentLayoutItem()` des entfernten Elements nicht auf dieses Layout verweist, da das Element als aus der Layout-Hierarchie entfernt gilt.

Soll das Layout anwendungsübergreifend wiederverwendet werden, empfehlen wir, dass das Layout das Element löscht; das Grafik-View-Framework ist jedoch nicht darauf angewiesen.

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

Siehe auch ` itemAt()` und ` count()`.

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

Legt die Inhaltsränder auf „ left “, „ top “, „ right “ und „ bottom “ fest. Die Standard-Inhaltsränder für Layouts der obersten Ebene sind stilabhängig (durch Abfrage der „pixelMetric“ für „ QStyle::PM_LayoutLeftMargin “, „ QStyle::PM_LayoutTopMargin “, „ QStyle::PM_LayoutRightMargin “ und „ QStyle::PM_LayoutBottomMargin “).

Für Unterlayouts betragen die Standardränder 0.

Das Ändern der Inhaltsränder macht das Layout automatisch ungültig.

Siehe auch ` invalidate()`.

[override virtual] void QGraphicsLayout::updateGeometry()

Implementiert: ` QGraphicsLayoutItem::updateGeometry()`.

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

Dieser virtuelle Ereignisbehandler empfängt alle Ereignisse für das verwaltete Widget. „ QGraphicsLayout “ nutzt diesen Ereignisbehandler, um auf layoutbezogene Ereignisse wie Geometrieänderungen, Layoutänderungen oder Änderungen der Layoutrichtung zu achten.

e ist ein Zeiger auf das Ereignis.

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

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