En esta página

QGraphicsItemGroup Class

La clase QGraphicsItemGroup proporciona un contenedor que trata un grupo de elementos como si fuera un único elemento. Más información...

Encabezado: #include <QGraphicsItemGroup>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
Heredado de: QGraphicsItem

Tipos públicos

enum { Type }

Funciones públicas

QGraphicsItemGroup(QGraphicsItem *parent = nullptr)
virtual ~QGraphicsItemGroup()
void addToGroup(QGraphicsItem *item)
void removeFromGroup(QGraphicsItem *item)

Funciones públicas reimplementadas

virtual QRectF boundingRect() const override
virtual bool isObscuredBy(const QGraphicsItem *item) const override
virtual QPainterPath opaqueArea() const override
virtual void paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget = nullptr) override
virtual int type() const override

Descripción detallada

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

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

La función boundingRect() de QGraphicsItemGroup devuelve el rectángulo delimitador de todos los elementos del grupo de elementos. QGraphicsItemGroup ignora el indicador ItemIgnoresTransformations de sus elementos hijos (es decir, con respecto a la geometría del elemento del grupo, los elementos hijos se tratan como si fueran transformables).

Hay dos formas de crear un grupo de elementos. El método más sencillo y habitual consiste en pasar una lista de elementos (por ejemplo, todos los elementos seleccionados) a QGraphicsScene::createItemGroup(), que devuelve un nuevo elemento QGraphicsItemGroup. El otro método consiste en crear manualmente un elemento QGraphicsItemGroup, añadirlo a la escena llamando a ` QGraphicsScene::addItem()` y, a continuación, añadir elementos al grupo manualmente, uno por uno, llamando a ` addToGroup()`. Para desmontar («desagrupar») un grupo de elementos, puede llamar a ` QGraphicsScene::destroyItemGroup()` o 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 y la transformación de los elementos con respecto a la escena, a diferencia de lo que ocurre al llamar a ` setParentItem()` (), donde solo se mantienen la posición y la transformación del elemento hijo con respecto al padre.

La función addtoGroup() reasigna el elemento de destino a este grupo de elementos, manteniendo intactas la posición y la transformación del elemento con respecto a 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 la de ` setParentItem()`; reasigna el elemento al elemento padre del grupo de elementos. Al igual que con ` addToGroup()`, la posición y la transformación del elemento relativas a la escena permanecen intactas.

Véase también QGraphicsItem y el marco de trabajo de la vista gráfica.

Documentación sobre tipos de miembros

[anonymous] enum

El valor devuelto por la función virtual type().

ConstanteValorDescripción
QGraphicsItemGroup::Type10Un grupo de elementos gráficos

Documentación de la función miembro

[explicit] QGraphicsItemGroup::QGraphicsItemGroup(QGraphicsItem *parent = nullptr)

Crea un `QGraphicsItemGroup`. Se pasa ` parent ` al constructor de ` QGraphicsItem`.

Véase también QGraphicsScene::addItem().

[virtual noexcept] QGraphicsItemGroup::~QGraphicsItemGroup()

Destruye el « QGraphicsItemGroup ».

void QGraphicsItemGroup::addToGroup(QGraphicsItem *item)

Añade el item especificado y los elementos secundarios de dicho elemento a este grupo de elementos. El elemento y sus elementos secundarios pasarán a pertenecer a este grupo, pero su posición y transformación con respecto a la escena se mantendrán intactas.

Véase también « removeFromGroup » () y « QGraphicsScene::createItemGroup » ().

[override virtual] QRectF QGraphicsItemGroup::boundingRect() const

Reimplementa: ` QGraphicsItem::boundingRect()` const.

Devuelve el rectángulo delimitador de este elemento de grupo y de todos sus elementos hijos.

[override virtual] bool QGraphicsItemGroup::isObscuredBy(const QGraphicsItem *item) const

Reimplementa: ` QGraphicsItem::isObscuredBy(const QGraphicsItem *item) const`.

[override virtual] QPainterPath QGraphicsItemGroup::opaqueArea() const

Reimplementa: ` QGraphicsItem::opaqueArea()` const.

[override virtual] void QGraphicsItemGroup::paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget = nullptr)

Reimplementa: ` QGraphicsItem::paint` (`QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget)`.

void QGraphicsItemGroup::removeFromGroup(QGraphicsItem *item)

Elimina el elemento « item » especificado de este grupo. El elemento pasará a estar vinculado al elemento padre de este grupo, o a 0 si este grupo no tiene padre. Su posición y transformación respecto a la escena se mantendrán intactas.

Véase también « addToGroup » () y « QGraphicsScene::destroyItemGroup » ().

[override virtual] int QGraphicsItemGroup::type() const

Reimplementa: ` QGraphicsItem::type()` const.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.