Подробное описание

Класс QGraphicsItemGroup предоставляет контейнер, который рассматривает группу элементов в качестве единого элемента.

QGraphicsItemGroup это специальный тип объединённого элемента, который рассматривает себя и всех своих потомков как один элемент (т.е. все элементы и геометрии для всех элементов объединяются вместе). Группы элементов обычно используются в инструментах представления, когда пользователь хочет сгруппировать несколько маленьких элементов в один большой, чтобы упростить перемещение и копирование элементов.

Если вы хотите только хранить элементы внутри других элементов, вы можете использовать любой QGraphicsItem непосредственно, передавая подходящего родителя функции setParentItem().

Функция boundingRect() QGraphicsItemGroup возвращает ограничивающий прямоугольник всех элементов группы. QGraphicsItemGroup игнорирует флаг ItemIgnoresTransformations на своих дочерних элементах (т.е. по отношению к геометрии элемента группы дочерние элементы трактуются, как будто они могут быть подвергнуты преобразованиям).

Есть два способа создать группу элементов. Простейший и наиболее распространённый подход это передать список элементов (например, все выделенные элементы) в QGraphicsScene::createItemGroup(), которая возвращает новый элемент QGraphicsItemGroup. Другой подход это вручную создать элемент QGraphicsItemGroup, добавить его на сцену вызвав QGraphicsScene::addItem(), а затем добавить элементы в группу вручную, по-одному, вызывая addToGroup(). Чтобы разобрать ("разгруппировать") группу элементов, вы можете или вызвать QGraphicsScene::destroyItemGroup(), или вручную удалить все элементы из группы вызывая removeFromGroup().

 // Группируем все выделенные элементы вместе
 QGraphicsItemGroup *group = scene->createItemGroup(scene->selecteditems());

 // Уничтожаем группу и удаляем элемент группы
 scene->destroyItemGroup(group);

Операции добавления и удаления элементов сохраняет их положения и преобразования относительно сцены, в отличие от setParentItem(), где сохраняются позиции и преобразования элементов только относительно родителя.

Функция addtoGroup() заменяет родителя указанного элемента на элемент этой группы, сохраняя его положение и преобразование по отношению к сцене неизменными. Визуально это означает, что элементы, добавленные с помощью addToGroup(), будут сохранятся полностью неизменными в результате этой операции, независимо от текущего положения или преобразования элемента или группы; хотя положение и матрица элемента скорее всего изменятся.

Функция removeFromGroup() имеет похожую на setParentItem() семантику; она изменяет родителя элемента на родительский элемент группы. Также и с addToGroup(), положение и преобразование элемента по отношению к сцене сохраняются неизменными.