En esta página

GridLayout QML Type

Ofrece una forma de organizar dinámicamente los elementos en una cuadrícula. Más...

Import Statement: import QtQuick.Layouts
Inherits:

Item

Propiedades

Descripción detallada

Para poder utilizar este tipo de forma más eficaz, se recomienda comprender el mecanismo general del módulo « Qt Quick Layouts». Consulte «Qt Quick: Descripción general de los diseños » para obtener más información.

Si se cambia el tamaño del GridLayout, todos los elementos del diseño se reorganizarán. Es similar al QGridLayout basado en widgets. Todos los elementos hijos visibles del elemento GridLayout formarán parte del diseño. Si desea un diseño con una sola fila o una sola columna, puede utilizar RowLayout o ColumnLayout. Estos ofrecen una API algo más cómoda y mejoran la legibilidad.

Por defecto, los elementos se ordenarán según la propiedad flow. El valor por defecto de la propiedad flow es GridLayout.LeftToRight.

Si se especifica la propiedad ` columns `, se considerará como el límite máximo de columnas que puede tener el diseño, antes de que el posicionamiento automático vuelva al principio de la siguiente fila. La propiedad ` columns ` solo se utiliza cuando ` flow ` es ` GridLayout.LeftToRight`.

Texto dispuesto en cuadrícula: Tres palabras en una fila

GridLayout {
    id: grid
    columns: 3

    Text { text: "Three"; font.bold: true; }
    Text { text: "words"; color: "red" }
    Text { text: "in"; font.underline: true }
    Text { text: "a"; font.pixelSize: 20 }
    Text { text: "row"; font.strikeout: true }
}

La propiedad « rows » funciona de manera similar, pero los elementos se posicionan automáticamente en vertical. La propiedad « rows » solo se utiliza cuando « flow » es « GridLayout.TopToBottom ».

Puede especificar qué celda desea que ocupe un elemento configurando las propiedades ` Layout.row ` y ` Layout.column `. También puede especificar el número de filas o columnas que abarca un elemento configurando las propiedades ` Layout.rowSpan ` o ` Layout.columnSpan `.

Los elementos de un GridLayout admiten estas propiedades asociadas:

Más información sobre las propiedades asociadas aquí.

Véase también la descripción general de los diseñosRowLayout, ColumnLayout, StackLayout, Grid y Qt Quick .

Documentación sobre propiedades

columnSpacing : real

Esta propiedad define el espaciado entre cada columna. El valor por defecto es « 5 ».

columns : int

Esta propiedad establece el límite de columnas para los elementos posicionados si « flow » es « GridLayout.LeftToRight ». El valor predeterminado es que no hay límite.

flow : enumeration

Esta propiedad determina la dirección del flujo de los elementos que no tienen definida una posición explícita en una celda. Se utiliza junto con las propiedades « columns » o « rows », que especifican cuándo se reinicia el flujo en la siguiente fila o columna, respectivamente.

Los valores posibles son:

ConstanteDescripción
GridLayout.LeftToRight(por defecto) Los elementos se colocan uno al lado del otro y, a continuación, se ajustan a la siguiente línea.
GridLayout.TopToBottomLos elementos se colocan uno al lado del otro de arriba abajo y, a continuación, se ajustan a la siguiente columna.

Véase también rows y columns.

layoutDirection : enumeration [since QtQuick.Layouts 1.1]

Esta propiedad determina la dirección de disposición de la cuadrícula; controla si los elementos se disponen de izquierda a derecha o de derecha a izquierda. Si se especifica « Qt.RightToLeft », los elementos alineados a la izquierda se alinearán a la derecha y los alineados a la derecha se alinearán a la izquierda.

Valores posibles:

ConstanteDescripción
Qt.LeftToRight(por defecto) Los elementos se disponen de izquierda a derecha.
Qt.RightToLeftLos elementos se disponen de derecha a izquierda.

Esta propiedad se introdujo en QtQuick.Layouts 1.1.

Véase también RowLayout::layoutDirection y ColumnLayout::layoutDirection.

rowSpacing : real

Esta propiedad define el espaciado entre cada fila. El valor predeterminado es « 5 ».

rows : int

Esta propiedad establece el límite de filas para los elementos posicionados si la opción « flow » está establecida en « GridLayout.TopToBottom ». El valor por defecto es que no hay límite.

uniformCellHeights : bool [since QtQuick.Layouts 6.6]

Si esta propiedad se establece en « true », el diseño obligará a todas las celdas a tener una altura uniforme. En este modo, el diseño pretende respetar « Layout.minimumHeight », « Layout.preferredHeight » y « Layout.maximumHeight », aunque puede que tenga que hacer concesiones para cumplir los requisitos de todos los elementos.

El valor por defecto es false.

Esta propiedad se introdujo en QtQuick.Layouts 6.6.

Véase también GridLayout::uniformCellWidths, RowLayout::uniformCellSizes y ColumnLayout::uniformCellSizes.

uniformCellWidths : bool [since QtQuick.Layouts 6.6]

Si esta propiedad se establece en « true », el diseño obligará a todas las celdas a tener un ancho uniforme. En este modo, el diseño pretende respetar Layout.minimumWidth, Layout.preferredWidth y Layout.maximumWidth, aunque puede que tenga que hacer concesiones para cumplir los requisitos de todos los elementos.

El valor por defecto es false.

Esta propiedad se introdujo en QtQuick.Layouts 6.6.

Véase también GridLayout::uniformCellHeights, RowLayout::uniformCellSizes y ColumnLayout::uniformCellSizes.

© 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.