QGraphicsItemGroup Class

Detaillierte Beschreibung

Eine QGraphicsItemGroup ist ein spezieller Typ eines zusammengesetzten Elements, das sich selbst und alle seine Kinder als ein Element behandelt (d.h. alle Ereignisse und Geometrien für alle Kinder werden zusammengeführt). Elementgruppen werden häufig in Präsentationswerkzeugen verwendet, wenn der Benutzer mehrere kleinere Elemente zu einem großen Element zusammenfassen möchte, um das Verschieben und Kopieren von Elementen zu vereinfachen.

Wenn Sie nur Elemente innerhalb anderer Elemente speichern möchten, können Sie jedes QGraphicsItem direkt verwenden, indem Sie setParentItem() ein geeignetes übergeordnetes Element übergeben.

Die Funktion boundingRect() von QGraphicsItemGroup gibt das Begrenzungsrechteck aller Elemente in der Elementgruppe zurück. QGraphicsItemGroup ignoriert das ItemIgnoresTransformations-Flag seiner Kinder (d.h. in Bezug auf die Geometrie des Gruppenelements werden die Kinder so behandelt, als ob sie transformierbar wären).

Es gibt zwei Möglichkeiten, eine Elementgruppe zu konstruieren. Der einfachste und gebräuchlichste Ansatz ist die Übergabe einer Liste von Elementen (z. B. alle ausgewählten Elemente) an QGraphicsScene::createItemGroup(), die ein neues QGraphicsItemGroup-Element zurückgibt. Die andere Methode besteht darin, ein QGraphicsItemGroup-Element manuell zu erstellen, es der Szene durch Aufruf von QGraphicsScene::addItem() hinzuzufügen und dann der Gruppe manuell Elemente hinzuzufügen, eines nach dem anderen durch Aufruf von addToGroup(). Um eine Elementgruppe aufzulösen, können Sie entweder QGraphicsScene::destroyItemGroup() aufrufen, oder Sie können alle Elemente manuell aus der Gruppe entfernen, indem Sie removeFromGroup() aufrufen.

// Group all selected items together
QGraphicsItemGroup *group = scene->createItemGroup(scene->selecteditems());

// Destroy the group, and delete the group item
scene->destroyItemGroup(group);

Beim Hinzufügen und Entfernen von Elementen bleiben die szenenbezogene Position und Transformation der Elemente erhalten, im Gegensatz zum Aufruf von setParentItem(), bei dem nur die szenenbezogene Position und Transformation des untergeordneten Elements beibehalten wird.

Die Funktion addtoGroup() fügt das Zielobjekt zu dieser Objektgruppe hinzu, wobei die Position und Transformation des Objekts relativ zur Szene erhalten bleibt. Visuell bedeutet dies, dass Elemente, die über addToGroup() hinzugefügt werden, als Ergebnis dieser Operation völlig unverändert bleiben, unabhängig von der aktuellen Position oder Transformation des Elements oder der Gruppe; obwohl sich die Position und Matrix des Elements wahrscheinlich ändern werden.

Die Funktion removeFromGroup() hat eine ähnliche Semantik wie setParentItem(); sie repariert das Element auf das übergeordnete Element der Elementgruppe. Wie bei addToGroup() bleiben die szenenbezogene Position und die Transformation des Elements intakt.