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().
| Constante | Valor | Descripción |
|---|---|---|
QGraphicsItemGroup::Type | 10 | Un 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.