QGraphicsItemGroup Class

Descripción Detallada

Un QGraphicsItemGroup es un tipo especial de ítem compuesto que se trata a sí mismo y a todos sus hijos como un solo ítem (es decir, todos los eventos y geometrías de todos los hijos se fusionan). Es habitual utilizar grupos de elementos en herramientas de presentación, cuando el usuario desea agrupar varios elementos pequeños en uno grande para simplificar el movimiento y la copia de elementos.

Si lo único que quieres es almacenar elementos dentro de otros elementos, puedes utilizar directamente cualquier QGraphicsItem pasando un padre adecuado a setParentItem().

La funcion boundingRect() de QGraphicsItemGroup devuelve el rectangulo delimitador de todos los items del grupo. QGraphicsItemGroup ignora la bandera ItemIgnoresTransformations en sus hijos (es decir, con respecto a la geometría del elemento del grupo, los hijos son tratados como si fueran transformables).

Hay dos maneras de construir un grupo de elementos. La más sencilla y común es pasar una lista de elementos (por ejemplo, todos los elementos seleccionados) a QGraphicsScene::createItemGroup(), que devuelve un nuevo elemento QGraphicsItemGroup. El otro método es construir manualmente un elemento QGraphicsItemGroup, añadirlo a la escena llamando a QGraphicsScene::addItem(), y luego añadir elementos al grupo manualmente, uno a uno llamando a addToGroup(). Para desmontar ("desagrupar") un grupo de elementos, puedes llamar a QGraphicsScene::destroyItemGroup(), o puedes eliminar manualmente todos los elementos del grupo llamando a removeFromGroup().

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

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

La operación de añadir y eliminar elementos conserva la posición relativa a la escena y la transformación de los elementos, a diferencia de la llamada a setParentItem(), en la que sólo se conservan la posición relativa al padre y la transformación del elemento hijo.

La función addtoGroup() vuelve a colocar el elemento de destino en este grupo de elementos, manteniendo intactas la posición y la transformación del elemento en relación con la escena. Visualmente, esto significa que los elementos añadidos mediante addToGroup() permanecerán completamente inalterados como resultado de esta operación, independientemente de la posición o transformación actual del elemento o del grupo; aunque es probable que la posición y la matriz del elemento cambien.

La función removeFromGroup() tiene una semántica similar a setParentItem(); devuelve el elemento al elemento padre del grupo de elementos. Al igual que con addToGroup(), la posición relativa a la escena y la transformación del elemento permanecen intactas.