QGraphicsItemGroup Class

Description détaillée

Un QGraphicsItemGroup est un type spécial d'élément composé qui se traite lui-même et tous ses enfants comme un seul élément (c'est-à-dire que tous les événements et 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 directement n'importe quel QGraphicsItem en passant un parent approprié à setParentItem().

La fonction boundingRect() de QGraphicsItemGroup renvoie le rectangle de délimitation de tous les éléments du groupe d'éléments. QGraphicsItemGroup ignore l'indicateur ItemIgnoresTransformations de ses enfants (c'est-à-dire qu'en ce qui concerne 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 construire un groupe d'éléments. L'approche la plus simple et la plus courante consiste à transmettre une liste d'éléments (par exemple, tous les éléments sélectionnés) à QGraphicsScene::createItemGroup(), qui renvoie un nouvel élément QGraphicsItemGroup. L'autre approche consiste à construire 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 ("ungroup") 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);

L'opération d'ajout et de suppression d'éléments préserve la position et la transformation des éléments par rapport à la scène, contrairement à l'appel à setParentItem(), où seules la position et la transformation de l'élément enfant par rapport au parent sont conservées.

La fonction addtoGroup() reporte l'élément cible dans ce groupe d'éléments, en conservant 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 complètement 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() a une sémantique similaire à celle de setParentItem() ; elle reporte l'élément sur l'élément parent du groupe d'éléments. Comme pour addToGroup(), la position et la transformation de l'élément par rapport à la scène restent intactes.