GridLayout QML Type

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

Import Statement:	`import QtQuick.Layouts`
Inherits:	Item

Lista de todos los miembros, incluidos los heredados

Propiedades

columnSpacing : real
columns : int
flow : enumeration
layoutDirection : enumeration (since QtQuick.Layouts 1.1)
rowSpacing : real
rows : int
uniformCellHeights : bool (since QtQuick.Layouts 6.6)
uniformCellWidths : bool (since QtQuick.Layouts 6.6)

Descripción detallada

Para poder utilizar este tipo de forma más eficiente, se recomienda comprender el mecanismo general del módulo Qt Quick Layouts. Consulte Qt Quick Layouts Overview 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 widget QGridLayout. Todos los hijos visibles del elemento GridLayout pertenecerán al diseño. Si desea un diseño con sólo una fila o una columna, puede utilizar las API RowLayout o ColumnLayout. Éstas ofrecen una API un poco 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 tratará como un límite máximo de cuántas columnas puede tener el diseño, antes de que el auto-posicionamiento vuelva al principio de la siguiente fila. La propiedad columns sólo se utiliza cuando flow es GridLayout.LeftToRight.

Texto ordenado 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 forma similar, pero los elementos se autoposicionan verticalmente. La propiedad rows sólo se utiliza cuando flow es GridLayout.TopToBottom.

Puede especificar qué celda desea que ocupe un elemento estableciendo las propiedades Layout.row y Layout.column. También puede especificar el espacio entre filas o columnas estableciendo las propiedades Layout.rowSpan o Layout.columnSpan.

Los elementos de un GridLayout admiten estas propiedades adjuntas:

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

Ver también RowLayout, ColumnLayout, StackLayout, Grid, y Qt Quick Visión General de los Layouts.

Documentación de propiedades

columnSpacing : real

Esta propiedad contiene el espaciado entre cada columna. El valor por defecto es 5.

columns : int

Esta propiedad contiene el límite de columnas para los elementos posicionados si flow es GridLayout.LeftToRight. El valor por defecto es que no hay límite.

flow : enumeration

Esta propiedad mantiene la dirección de flujo de los elementos que no tienen una posición de celda explícita establecida. Se utiliza junto con las propiedades columns o rows, que especifican cuándo el flujo se restablece a la siguiente fila o columna respectivamente.

Los valores posibles son:

Constante	Descripción
`GridLayout.LeftToRight`	(por defecto) Los ítems se posicionan uno al lado del otro, y luego pasan a la siguiente línea.
`GridLayout.TopToBottom`	Los elementos se colocan uno al lado del otro de arriba a abajo, y luego se desplazan a la siguiente columna.

Véase también rows y columns.

layoutDirection : enumeration `[since QtQuick.Layouts 1.1]`

Esta propiedad contiene la dirección de la disposición de la rejilla - 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:

Constante	Descripción
`Qt.LeftToRight`	(por defecto) Los elementos se disponen de izquierda a derecha.
`Qt.RightToLeft`	Los elementos se disponen de derecha a izquierda.

Esta propiedad se introdujo en QtQuick.Layouts 1.1.

Ver también RowLayout::layoutDirection y ColumnLayout::layoutDirection.

rowSpacing : real

Esta propiedad contiene el espaciado entre cada fila. El valor por defecto es 5.

rows : int

Esta propiedad contiene el límite de filas para los elementos posicionados si flow es 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 forzará a todas las celdas a tener una altura uniforme. El diseño intenta respetar Layout.minimumHeight, Layout.preferredHeight y Layout.maximumHeight en este modo, pero puede 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.

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

uniformCellWidths : bool `[since QtQuick.Layouts 6.6]`

Si esta propiedad se establece en true, la maquetación forzará a todas las celdas a tener una anchura uniforme. La maquetación intenta respetar Layout.minimumWidth, Layout.preferredWidth y Layout.maximumWidth en este modo, pero puede hacer concesiones para cumplir los requisitos de todos los elementos.