QGraphicsItemGroup Class

Description détaillée

Un QGraphicsItemGroup est un type particulier d’élément composite qui se considère lui-même, ainsi que tous ses enfants, comme un seul élément (c’est-à-dire que tous les événements et toutes les géométries de tous les enfants sont fusionnés). Il est courant d’utiliser des groupes d’éléments dans les outils de présentation, lorsque l’utilisateur souhaite regrouper plusieurs petits éléments en un seul grand élément afin de simplifier le déplacement et la copie des éléments.

Si vous souhaitez simplement stocker des éléments à l’intérieur d’autres éléments, vous pouvez utiliser n’importe quel QGraphicsItem directement en passant un parent approprié à la fonction setParentItem().

La fonction boundingRect() de QGraphicsItemGroup renvoie le rectangle englobant de tous les éléments du groupe d’éléments. QGraphicsItemGroup ignore l’indicateur ItemIgnoresTransformations sur ses enfants (c’est-à-dire que, par rapport à la géométrie de l’élément du groupe, les enfants sont traités comme s’ils étaient transformables).

Il existe deux façons de créer un groupe d’éléments. L’approche la plus simple et la plus courante consiste à passer une liste d’éléments (par exemple, tous les éléments sélectionnés) à la fonction QGraphicsScene::createItemGroup(), qui renvoie un nouvel élément de type QGraphicsItemGroup. L'autre approche consiste à créer manuellement un élément QGraphicsItemGroup, à l'ajouter à la scène en appelant ` QGraphicsScene::addItem()` (), puis à ajouter manuellement des éléments au groupe, un par un, en appelant ` addToGroup()` (). Pour démanteler (« dégrouper ») un groupe d’éléments, vous pouvez soit appeler ` QGraphicsScene::destroyItemGroup()`, soit supprimer manuellement tous les éléments du groupe en appelant ` removeFromGroup()`.

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

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

Les opérations d’ajout et de suppression d’éléments préservent la position et la transformation de ces éléments par rapport à la scène, contrairement à l’appel de la fonction ` setParentItem()`, qui ne conserve que la position et la transformation de l’élément enfant par rapport à son parent.

La fonction addtoGroup() réaffecte l’élément cible à ce groupe d’éléments, en conservant intactes la position et la transformation de l’élément par rapport à la scène. Visuellement, cela signifie que les éléments ajoutés via addToGroup() resteront totalement inchangés à la suite de cette opération, quelle que soit la position ou la transformation actuelle de l’élément ou du groupe ; bien que la position et la matrice de l’élément soient susceptibles de changer.

La fonction ` removeFromGroup()` présente une sémantique similaire à celle de ` setParentItem()` ; elle réaffecte l'élément à l'élément parent du groupe d'éléments. Comme avec ` addToGroup()`, la position et la transformation de l'élément par rapport à la scène restent inchangées.