QGraphicsLayout Class
La clase QGraphicsLayout constituye la clase base para todos los diseños de Graphics View. Más información...
| Encabezado: | #include <QGraphicsLayout> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Heredado de: | QGraphicsLayoutItem |
| Heredado por: | QGraphicsAnchorLayout, ` QGraphicsGridLayout` y QGraphicsLinearLayout |
Funciones públicas
| QGraphicsLayout(QGraphicsLayoutItem *parent = nullptr) | |
| virtual | ~QGraphicsLayout() |
| void | activate() |
| virtual int | count() const = 0 |
| virtual void | invalidate() |
| bool | isActivated() const |
| virtual QGraphicsLayoutItem * | itemAt(int i) const = 0 |
| virtual void | removeAt(int index) = 0 |
| void | setContentsMargins(qreal left, qreal top, qreal right, qreal bottom) |
| virtual void | widgetEvent(QEvent *e) |
Funciones públicas reimplementadas
| virtual void | getContentsMargins(qreal *left, qreal *top, qreal *right, qreal *bottom) const override |
| virtual void | updateGeometry() override |
Funciones protegidas
| void | addChildLayoutItem(QGraphicsLayoutItem *layoutItem) |
Descripción detallada
`QGraphicsLayout` es una clase abstracta que define una API virtual para organizar los elementos secundarios de ` QGraphicsWidget ` y otros objetos ` QGraphicsLayoutItem ` para un ` QGraphicsWidget`. ` QGraphicsWidget ` asigna la responsabilidad a un `QGraphicsLayout` mediante ` QGraphicsWidget::setLayout()`. A medida que se redimensiona el widget, el diseño organizará automáticamente los elementos secundarios del widget. QGraphicsLayout hereda de QGraphicsLayoutItem, por lo que puede ser gestionado por cualquier diseño, incluidas sus propias subclases.
Creación de un diseño personalizado
Se puede utilizar QGraphicsLayout como base para escribir un diseño personalizado (por ejemplo, un «flowlayout»), pero es más habitual utilizar una de sus subclases: QGraphicsLinearLayout o QGraphicsGridLayout. Al crear un diseño personalizado, como mínimo se deben reimplementar las siguientes funciones:
| Función | Descripción |
|---|---|
| QGraphicsLayoutItem::setGeometry() | Te avisa cuando se establece la geometría del diseño. Puedes almacenar la geometría en tu propia clase de diseño mediante una reimplementación de esta función. |
| QGraphicsLayoutItem::sizeHint() | Devuelve las sugerencias de tamaño del diseño. |
| QGraphicsLayout::count() | Devuelve el número de elementos del diseño. |
| QGraphicsLayout::itemAt() | Devuelve un puntero a un elemento del diseño. |
| QGraphicsLayout::removeAt() | Elimina un elemento del diseño sin destruirlo. |
Para obtener más detalles sobre cómo implementar cada función, consulta la documentación de cada función.
Cada diseño define su propia API para organizar widgets y elementos del diseño. Por ejemplo, en un diseño de cuadrícula, se necesita un índice de fila y de columna, con opciones como el número de filas y columnas que abarca, la alineación, el espaciado y mucho más. Un diseño lineal, sin embargo, requiere un único índice de fila o columna para posicionar sus elementos. En el caso de un diseño de cuadrícula, el orden de inserción no afecta al diseño en absoluto, pero en un diseño lineal, el orden es esencial. Al escribir tu propia subclase de diseño, tienes libertad para elegir la API que mejor se adapte a tu diseño.
QGraphicsLayout proporciona la función de conveniencia ` addChildLayoutItem()` para añadir elementos de diseño a un diseño personalizado. La función reasignará automáticamente los elementos gráficos a un padre nuevo, si es necesario.
Activación del diseño
Cuando cambia la geometría del diseño, QGraphicsLayout reorganiza inmediatamente todos los elementos que gestiona llamando a setGeometry() en cada uno de ellos. A esta reorganización se le denomina «activación del diseño».
QGraphicsLayout actualiza su propia geometría para que coincida con el contentsRect() del QGraphicsLayoutItem que está gestionando. De este modo, reorganizará automáticamente todos sus elementos cuando se cambie el tamaño del widget. QGraphicsLayout almacena en caché los tamaños de todos los elementos que gestiona para evitar llamar a setGeometry() con demasiada frecuencia.
Nota: Un QGraphicsLayout tendrá la misma geometría que el contentsRect() del widget (no del diseño) al que está asignado.
Activación implícita del diseño
El diseño se puede activar de forma implícita de dos maneras: llamando a ` activate()` o a ` invalidate()`. Al llamar a ` activate()`, el diseño se activa inmediatamente. Por el contrario, la llamada a ` invalidate()` se retrasa, ya que envía un evento ` LayoutRequest ` al widget gestionado. Debido a la compresión de eventos, la función ` activate()` solo se llamará una vez, una vez que el control haya vuelto al bucle de eventos. A esto se le denomina «invalidar el diseño». Al invalidar el diseño, también se invalida cualquier información almacenada en caché. Además, la función invalidate() es una función virtual. Por lo tanto, puedes invalidar tu propia caché en una subclase de QGraphicsLayout reimplementando esta función.
Gestión de eventos
QGraphicsLayout escucha los eventos del widget que gestiona a través del controlador de eventos virtual widgetEvent(). Cuando el diseño se asigna a un widget, todos los eventos enviados al widget son procesados primero por widgetEvent(). Esto permite que el diseño detecte cualquier cambio de estado relevante en el widget, como cambios de visibilidad o cambios en la dirección del diseño.
Gestión de márgenes
Los márgenes de un QGraphicsLayout pueden modificarse reimplementando setContentsMargins() y getContentsMargins().
Documentación de las funciones miembro
QGraphicsLayout::QGraphicsLayout(QGraphicsLayoutItem *parent = nullptr)
Crea un objeto QGraphicsLayout.
parent Se pasa al constructor de ` QGraphicsLayoutItem` y el argumento `isLayout` de ` QGraphicsLayoutItem` se establece en `true`.
Si ` parent ` es un ` QGraphicsWidget `, el diseño se instalará en ese widget. (Ten en cuenta que al instalar un diseño se eliminará el anterior).
[virtual noexcept] QGraphicsLayout::~QGraphicsLayout()
Elimina el objeto « QGraphicsLayout ».
void QGraphicsLayout::activate()
Activa la disposición, lo que provoca que todos los elementos de la misma se reorganicen inmediatamente. Esta función se basa en llamar a ` count()` y ` itemAt()`, y a continuación llamar a ` setGeometry()` en todos los elementos de forma secuencial. Al activarse, la disposición ajustará su geometría a la llamada ` contentsRect()` de su elemento padre. A continuación, el elemento padre invalidará cualquier disposición propia.
Si se invoca en secuencia o de forma recursiva, por ejemplo, por uno de los elementos dispuestos en respuesta a un cambio de tamaño, esta función no hará nada.
Ten en cuenta que el diseño puede utilizar el almacenamiento en caché de la geometría para optimizar este proceso. Para invalidar de forma forzada dicha caché, puedes llamar a ` invalidate()` antes de llamar a `activate()`.
Véase también invalidate().
[protected] void QGraphicsLayout::addChildLayoutItem(QGraphicsLayoutItem *layoutItem)
Esta función es una función de ayuda diseñada para diseños personalizados; recorre todos los elementos del diseño y vuelve a vincular sus elementos gráficos al antepasado más cercano de tipo « QGraphicsWidget » del diseño.
Si layoutItem ya se encuentra en otro diseño, se eliminará de dicho diseño.
Si los diseños personalizados desean un comportamiento especial, pueden optar por no utilizar esta función e implementar su propio comportamiento.
Véase también graphicsItem().
[pure virtual] int QGraphicsLayout::count() const
Esta función virtual pura debe reimplementarse en una subclase de ` QGraphicsLayout ` para devolver el número de elementos del diseño.
La subclase es libre de decidir cómo almacenar los elementos.
Véase también itemAt() y removeAt().
[override virtual] void QGraphicsLayout::getContentsMargins(qreal *left, qreal *top, qreal *right, qreal *bottom) const
Reimplementa: ` QGraphicsLayoutItem::getContentsMargins(qreal *left, qreal *top, qreal *right, qreal *bottom) const`.
[virtual] void QGraphicsLayout::invalidate()
Borra toda la información almacenada en caché sobre geometría y sugerencias de tamaño del diseño, y envía un evento « LayoutRequest » al elemento padre gestionado « QGraphicsLayoutItem ».
Véase también activate() y setGeometry().
bool QGraphicsLayout::isActivated() const
Devuelve « true » si el diseño se está activando en ese momento; en caso contrario, devuelve « false ». Si el diseño se está activando, esto significa que actualmente se encuentra en proceso de reorganizar sus elementos (es decir, se ha llamado a la función « activate()» y aún no ha devuelto ningún valor).
Véanse también activate() y invalidate().
[pure virtual] QGraphicsLayoutItem *QGraphicsLayout::itemAt(int i) const
Esta función virtual pura debe reimplementarse en una subclase de ` QGraphicsLayout ` para devolver un puntero al elemento situado en el índice ` i`. La reimplementación puede dar por hecho que ` i ` es válida (es decir, que respeta el valor de ` count()`). Junto con ` count()`, se proporciona como un medio para iterar sobre todos los elementos de una disposición.
La subclase es libre de decidir cómo almacenar los elementos, y la disposición visual no tiene por qué reflejarse a través de esta función.
Véase también count() y removeAt().
[pure virtual] void QGraphicsLayout::removeAt(int index)
Esta función virtual pura debe reimplementarse en una subclase de ` QGraphicsLayout ` para eliminar el elemento en ` index`. La reimplementación puede dar por hecho que ` index ` es válida (es decir, que respeta el valor de ` count()`).
La implementación debe garantizar que el parentLayoutItem() del elemento eliminado no apunte a este diseño, ya que se considera que el elemento ha sido eliminado de la jerarquía de diseños.
Si el diseño va a reutilizarse entre aplicaciones, recomendamos que el diseño elimine el elemento, pero el marco de trabajo de la vista gráfica no depende de ello.
La subclase es libre de decidir cómo almacenar los elementos.
Véanse también itemAt() y count().
void QGraphicsLayout::setContentsMargins(qreal left, qreal top, qreal right, qreal bottom)
Establece los márgenes del contenido en left, top, right y bottom. Los márgenes predeterminados del contenido para los diseños de nivel superior dependen del estilo (consultando la propiedad pixelMetric para QStyle::PM_LayoutLeftMargin, QStyle::PM_LayoutTopMargin, QStyle::PM_LayoutRightMargin y QStyle::PM_LayoutBottomMargin).
En el caso de los subdiseños, los márgenes predeterminados son 0.
Al modificar los márgenes de contenido, el diseño queda automáticamente invalidado.
Véase también invalidate().
[override virtual] void QGraphicsLayout::updateGeometry()
Reimplementa: QGraphicsLayoutItem::updateGeometry().
[virtual] void QGraphicsLayout::widgetEvent(QEvent *e)
Este controlador de eventos virtual recibe todos los eventos del widget gestionado. QGraphicsLayout utiliza este controlador de eventos para detectar eventos relacionados con el diseño, como cambios en la geometría, cambios en el diseño o cambios en la dirección del diseño.
e es un puntero al evento.
Puedes reimplementar este controlador de eventos para realizar un seguimiento de eventos similares en tu propio diseño personalizado.
Véase también « QGraphicsWidget::event()» y « QGraphicsItem::sceneEvent()».
© 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.