QGraphicsGridLayout Class
La clase QGraphicsGridLayout proporciona un diseño en cuadrícula para gestionar widgets en Graphics View. Más información...
| Encabezado: | #include <QGraphicsGridLayout> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Heredado de: | QGraphicsLayout |
Funciones públicas
| QGraphicsGridLayout(QGraphicsLayoutItem *parent = nullptr) | |
| virtual | ~QGraphicsGridLayout() |
| void | addItem(QGraphicsLayoutItem *item, int row, int column, Qt::Alignment alignment = Qt::Alignment()) |
| void | addItem(QGraphicsLayoutItem *item, int row, int column, int rowSpan, int columnSpan, Qt::Alignment alignment = Qt::Alignment()) |
| Qt::Alignment | alignment(QGraphicsLayoutItem *item) const |
| Qt::Alignment | columnAlignment(int column) const |
| int | columnCount() const |
| qreal | columnMaximumWidth(int column) const |
| qreal | columnMinimumWidth(int column) const |
| qreal | columnPreferredWidth(int column) const |
| qreal | columnSpacing(int column) const |
| int | columnStretchFactor(int column) const |
| qreal | horizontalSpacing() const |
| QGraphicsLayoutItem * | itemAt(int row, int column) const |
| void | removeItem(QGraphicsLayoutItem *item) |
| Qt::Alignment | rowAlignment(int row) const |
| int | rowCount() const |
| qreal | rowMaximumHeight(int row) const |
| qreal | rowMinimumHeight(int row) const |
| qreal | rowPreferredHeight(int row) const |
| qreal | rowSpacing(int row) const |
| int | rowStretchFactor(int row) const |
| void | setAlignment(QGraphicsLayoutItem *item, Qt::Alignment alignment) |
| void | setColumnAlignment(int column, Qt::Alignment alignment) |
| void | setColumnFixedWidth(int column, qreal width) |
| void | setColumnMaximumWidth(int column, qreal width) |
| void | setColumnMinimumWidth(int column, qreal width) |
| void | setColumnPreferredWidth(int column, qreal width) |
| void | setColumnSpacing(int column, qreal spacing) |
| void | setColumnStretchFactor(int column, int stretch) |
| void | setHorizontalSpacing(qreal spacing) |
| void | setRowAlignment(int row, Qt::Alignment alignment) |
| void | setRowFixedHeight(int row, qreal height) |
| void | setRowMaximumHeight(int row, qreal height) |
| void | setRowMinimumHeight(int row, qreal height) |
| void | setRowPreferredHeight(int row, qreal height) |
| void | setRowSpacing(int row, qreal spacing) |
| void | setRowStretchFactor(int row, int stretch) |
| void | setSpacing(qreal spacing) |
| void | setVerticalSpacing(qreal spacing) |
| qreal | verticalSpacing() const |
Funciones públicas reimplementadas
| virtual int | count() const override |
| virtual void | invalidate() override |
| virtual QGraphicsLayoutItem * | itemAt(int index) const override |
| virtual void | removeAt(int index) override |
| virtual void | setGeometry(const QRectF &rect) override |
| virtual QSizeF | sizeHint(Qt::SizeHint which, const QSizeF &constraint = QSizeF()) const override |
Descripción detallada
La forma más habitual de utilizar QGraphicsGridLayout es crear un objeto en el montón, pasando un widget padre al constructor, y a continuación añadir widgets y diseños llamando a addItem(). QGraphicsGridLayout calcula automáticamente las dimensiones de la cuadrícula a medida que se añaden elementos.
QGraphicsScene scene;
QGraphicsWidget *textEdit = scene.addWidget(new QTextEdit);
QGraphicsWidget *pushButton = scene.addWidget(new QPushButton);
QGraphicsWidget *form = new QGraphicsWidget;
scene.addItem(form);
QGraphicsGridLayout *layout = new QGraphicsGridLayout(form);
layout->addItem(textEdit, 0, 0);
layout->addItem(pushButton, 0, 1);Por otra parte, si no se pasa un widget padre al constructor del diseño, será necesario llamar a ` QGraphicsWidget::setLayout()` para establecer este diseño como el diseño de nivel superior de ese widget; de este modo, el widget asumirá la propiedad del diseño.
El diseño asume la propiedad de los elementos. En algunos casos, cuando el elemento del diseño también hereda de QGraphicsItem (como QGraphicsWidget), se producirá una ambigüedad en la propiedad, ya que el elemento del diseño pertenece a dos jerarquías de propiedad. Consulte la documentación de QGraphicsLayoutItem::setOwnedByLayout() para saber cómo gestionar esto. Puede acceder a cada elemento del diseño llamando a count() y a itemAt(). Al llamar a removeAt(), se eliminará un elemento del diseño, sin destruirlo.
Indicaciones de tamaño y políticas de tamaño en QGraphicsGridLayout
QGraphicsGridLayout respeta las sugerencias de tamaño y las políticas de tamaño de cada elemento, y cuando una celda de la cuadrícula tiene más espacio del que los elementos pueden ocupar, cada elemento se dispone según la alineación que el diseño establezca para ese elemento. Puedes establecer una alineación para cada elemento llamando a ` setAlignment()` y comprobar la alineación de cualquier elemento llamando a ` alignment()`. También puedes establecer la alineación de toda una fila o columna llamando a ` setRowAlignment()` y ` setColumnAlignment()`, respectivamente. Por defecto, los elementos se alinean en la esquina superior izquierda.
Véase también QGraphicsLinearLayout y QGraphicsWidget.
Documentación de funciones de miembro
QGraphicsGridLayout::QGraphicsGridLayout(QGraphicsLayoutItem *parent = nullptr)
Crea una instancia de `QGraphicsGridLayout`. Se pasa ` parent ` al constructor de ` QGraphicsLayout`.
[virtual noexcept] QGraphicsGridLayout::~QGraphicsGridLayout()
Elimina el objeto « QGraphicsGridLayout ».
void QGraphicsGridLayout::addItem(QGraphicsLayoutItem *item, int row, int column, Qt::Alignment alignment = Qt::Alignment())
Añade « item » a la tabla de row y column. Puedes especificar un « alignment » opcional para item.
void QGraphicsGridLayout::addItem(QGraphicsLayoutItem *item, int row, int column, int rowSpan, int columnSpan, Qt::Alignment alignment = Qt::Alignment())
Añade « item » a la tabla de row y column. Puedes especificar « rowSpan » y « columnSpan », así como, de forma opcional, « alignment ».
Qt::Alignment QGraphicsGridLayout::alignment(QGraphicsLayoutItem *item) const
Devuelve la alineación de item.
Véase también setAlignment().
Qt::Alignment QGraphicsGridLayout::columnAlignment(int column) const
Devuelve la alineación de column.
Véase también setColumnAlignment().
int QGraphicsGridLayout::columnCount() const
Devuelve el número de columnas del diseño de cuadrícula. Este número es siempre uno más que el índice de la última columna ocupada por un elemento del diseño (se cuentan las columnas vacías, salvo las que se encuentran al final).
qreal QGraphicsGridLayout::columnMaximumWidth(int column) const
Devuelve la anchura máxima de column.
Véase también setColumnMaximumWidth().
qreal QGraphicsGridLayout::columnMinimumWidth(int column) const
Devuelve el ancho mínimo de column.
Véase también setColumnMinimumWidth().
qreal QGraphicsGridLayout::columnPreferredWidth(int column) const
Devuelve el ancho preferido para column.
Véase también setColumnPreferredWidth().
qreal QGraphicsGridLayout::columnSpacing(int column) const
Devuelve el espaciado entre columnas para column.
Véase también setColumnSpacing().
int QGraphicsGridLayout::columnStretchFactor(int column) const
Devuelve el factor de estiramiento de column.
Véase también setColumnStretchFactor().
[override virtual] int QGraphicsGridLayout::count() const
Reimplementa: QGraphicsLayout::count() const.
Devuelve el número de elementos de diseño que hay en este diseño de cuadrícula.
qreal QGraphicsGridLayout::horizontalSpacing() const
Devuelve el espaciado horizontal predeterminado para el diseño de cuadrícula.
Véase también setHorizontalSpacing().
[override virtual] void QGraphicsGridLayout::invalidate()
Reimplementa: QGraphicsLayout::invalidate().
[override virtual] QGraphicsLayoutItem *QGraphicsGridLayout::itemAt(int index) const
Reimplementa: ` QGraphicsLayout::itemAt(int i) const`.
Devuelve el elemento de diseño situado en index, o nullptr si no hay ningún elemento de diseño en este índice.
QGraphicsLayoutItem *QGraphicsGridLayout::itemAt(int row, int column) const
Devuelve un puntero al elemento de diseño situado en (row, column).
[override virtual] void QGraphicsGridLayout::removeAt(int index)
Reimplementa: QGraphicsLayout::removeAt(int index).
Elimina el elemento de diseño situado en index sin destruirlo. La propiedad del elemento se transfiere al llamante.
Véase también addItem().
void QGraphicsGridLayout::removeItem(QGraphicsLayoutItem *item)
Elimina el elemento de diseño « item » sin destruirlo. La propiedad del elemento se transfiere al usuario que realiza la llamada.
Véase también addItem().
Qt::Alignment QGraphicsGridLayout::rowAlignment(int row) const
Devuelve la alineación de row.
Véase también setRowAlignment().
int QGraphicsGridLayout::rowCount() const
Devuelve el número de filas del diseño de cuadrícula. Este valor es siempre uno más que el índice de la última fila ocupada por un elemento del diseño (se cuentan las filas vacías, salvo las que se encuentran al final).
qreal QGraphicsGridLayout::rowMaximumHeight(int row) const
Devuelve la altura máxima de la fila, row.
Véase también ` setRowMaximumHeight()`.
qreal QGraphicsGridLayout::rowMinimumHeight(int row) const
Devuelve la altura mínima de la fila, row.
Véase también setRowMinimumHeight().
qreal QGraphicsGridLayout::rowPreferredHeight(int row) const
Devuelve la altura preferida para la fila, row.
Véase también setRowPreferredHeight().
qreal QGraphicsGridLayout::rowSpacing(int row) const
Devuelve el espaciado entre filas de row.
Véase también setRowSpacing().
int QGraphicsGridLayout::rowStretchFactor(int row) const
Devuelve el factor de estiramiento de row.
Véase también setRowStretchFactor().
void QGraphicsGridLayout::setAlignment(QGraphicsLayoutItem *item, Qt::Alignment alignment)
Establece la alineación de item en alignment.
Véase también alignment().
void QGraphicsGridLayout::setColumnAlignment(int column, Qt::Alignment alignment)
Establece la alineación de column en alignment.
Véase también columnAlignment().
void QGraphicsGridLayout::setColumnFixedWidth(int column, qreal width)
Establece el ancho fijo de column en width.
void QGraphicsGridLayout::setColumnMaximumWidth(int column, qreal width)
Establece el ancho máximo de column en width.
Véase también columnMaximumWidth().
void QGraphicsGridLayout::setColumnMinimumWidth(int column, qreal width)
Establece el ancho mínimo de column en width.
Véase también columnMinimumWidth().
void QGraphicsGridLayout::setColumnPreferredWidth(int column, qreal width)
Establece el ancho preferido de column en width.
Véase también columnPreferredWidth().
void QGraphicsGridLayout::setColumnSpacing(int column, qreal spacing)
Establece el espaciado de column a spacing.
Véase también columnSpacing().
void QGraphicsGridLayout::setColumnStretchFactor(int column, int stretch)
Establece el factor de estiramiento de « column » en « stretch ».
Véase también columnStretchFactor().
[override virtual] void QGraphicsGridLayout::setGeometry(const QRectF &rect)
Reimplementa: QGraphicsLayoutItem::setGeometry(const QRectF &rect).
Establece la geometría delimitadora del diseño de cuadrícula en rect.
void QGraphicsGridLayout::setHorizontalSpacing(qreal spacing)
Establece el espaciado horizontal predeterminado del diseño de cuadrícula en « spacing ».
Véase también ` horizontalSpacing()`.
void QGraphicsGridLayout::setRowAlignment(int row, Qt::Alignment alignment)
Establece la alineación de row en alignment.
Véase también rowAlignment().
void QGraphicsGridLayout::setRowFixedHeight(int row, qreal height)
Establece la altura fija de la fila « row » en « height ».
void QGraphicsGridLayout::setRowMaximumHeight(int row, qreal height)
Establece la altura máxima de la fila, row, en height.
Véase también rowMaximumHeight().
void QGraphicsGridLayout::setRowMinimumHeight(int row, qreal height)
Establece la altura mínima de la fila, row, en height.
Véase también rowMinimumHeight().
void QGraphicsGridLayout::setRowPreferredHeight(int row, qreal height)
Establece la altura preferida para la fila « row » en « height ».
Véase también rowPreferredHeight().
void QGraphicsGridLayout::setRowSpacing(int row, qreal spacing)
Establece el espaciado de row a spacing.
Véase también rowSpacing().
void QGraphicsGridLayout::setRowStretchFactor(int row, int stretch)
Establece el factor de ampliación de row en stretch.
Véase también rowStretchFactor().
void QGraphicsGridLayout::setSpacing(qreal spacing)
Establece el espaciado predeterminado del diseño de cuadrícula, tanto vertical como horizontal, en « spacing ».
Véase también rowSpacing() y columnSpacing().
void QGraphicsGridLayout::setVerticalSpacing(qreal spacing)
Establece el espaciado vertical predeterminado del diseño de cuadrícula en « spacing ».
Véase también verticalSpacing().
[override virtual] QSizeF QGraphicsGridLayout::sizeHint(Qt::SizeHint which, const QSizeF &constraint = QSizeF()) const
Reimplementa: ` QGraphicsLayoutItem::sizeHint(Qt::SizeHint which, const QSizeF &constraint) const`.
qreal QGraphicsGridLayout::verticalSpacing() const
Devuelve el espaciado vertical predeterminado para el diseño de cuadrícula.
Véase también setVerticalSpacing().
© 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.