QGraphicsItemGroup Class

Ausführliche Beschreibung

Ein QGraphicsItemGroup ist eine spezielle Art von zusammengesetztem Element, das sich selbst und alle seine untergeordneten Elemente als ein einziges Element behandelt (d. h., alle Ereignisse und Geometrien aller untergeordneten Elemente werden zusammengeführt). Item-Gruppen werden häufig in Präsentationswerkzeugen verwendet, wenn der Benutzer mehrere kleinere Elemente zu einem großen Element gruppieren möchte, um das Verschieben und Kopieren von Elementen zu vereinfachen.

Wenn Sie lediglich Elemente in anderen Elementen speichern möchten, können Sie jede beliebige ` QGraphicsItem ` direkt verwenden, indem Sie ein geeignetes übergeordnetes Element an ` setParentItem()` übergeben.

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

Es gibt zwei Möglichkeiten, eine Elementgruppe zu erstellen. Der einfachste und gängigste Ansatz besteht darin, eine Liste von Elementen (z. B. alle ausgewählten Elemente) an ` QGraphicsScene::createItemGroup()` zu übergeben, wodurch ein neues `QGraphicsItemGroup`-Element zurückgegeben wird. Der andere Ansatz besteht darin, ein „QGraphicsItemGroup“-Element manuell zu erstellen, es mit dem Aufruf von „ QGraphicsScene::addItem()“ zur Szene hinzuzufügen und dann Elemente einzeln manuell zur Gruppe hinzuzufügen, indem man „ addToGroup()“ aufruft. Um eine Elementgruppe aufzulösen („ungroup“), können Sie entweder ` QGraphicsScene::destroyItemGroup()` aufrufen oder 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 deren szenenrelative Position und Transformation erhalten – im Gegensatz zum Aufruf von „ setParentItem()“, bei dem nur die elternrelative Position und Transformation des untergeordneten Elements beibehalten werden.

Die Funktion `addtoGroup()` ordnet das Zielelement dieser Elementgruppe neu zu, wobei die Position und Transformation des Elements relativ zur Szene erhalten bleiben. Optisch bedeutet dies, dass Elemente, die über ` addToGroup()` hinzugefügt wurden, durch diesen Vorgang völlig unverändert bleiben, unabhängig von der aktuellen Position oder Transformation des Elements oder der Gruppe; allerdings ändern sich wahrscheinlich die Position und die Matrix des Elements.

Die Funktion „ removeFromGroup()“ weist eine ähnliche Semantik wie „ setParentItem();“ auf; sie ordnet das Element dem übergeordneten Element der Elementgruppe zu. Wie bei „ addToGroup()“ bleiben die szenenbezogene Position und Transformation des Elements unverändert.