Тип QML GridLayout

Предоставляет способ динамичного размещения элементов в сетке. Подробнее...

• Список всех членов, включая наследуемые

Свойства

• columnSpacing : вещественное
• columns : целое
• flow : перечисление
• layoutDirection : перечисление
• rowSpacing : вещественное
• rows : целое

Подробное описание

Если GridLayout изменяет размер, все элементы в макете будут переупорядочены. Он похож на QGridLayout на основе виджетов. Все видимые дочерние элементы элемента GridLayout будут принадлежать макету. Если вам нужен макет только с одной строкой или одним столбцом, можно использовать RowLayout или ColumnLayout. Они предлагают более удобный API и улучшают читаемость.

По умолчанию элементы будут упорядочены в соответствии со свойством flow. Значение по умолчанию свойства flow равно GridLayout.LeftToRight.

Если указано свойство columns, оно будет рассматриваться как максимальное ограничение количества столбцов, которое может иметь макет, прежде чем автоматическое позиционирование вернется к началу следующей строки. Свойство columns используется только тогда, когда flow равно GridLayout.LeftToRight.

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 }
}

Свойство rows работает аналогично, но элементы автоматически позиционируются вертикально. Свойство rows используется только тогда, когда flow равно GridLayout.TopToBottom.

Можно указать ячейку, которую должен занимать элемент, задав свойства Layout.row и Layout.column. Также можно указать интервал строк или столбцов, задав свойства Layout.rowSpan или Layout.columnSpan.

Элементы в GridLayout поддерживают эти присоединённые свойства:

• Layout.row
• Layout.column
• Layout.rowSpan
• Layout.columnSpan
• Layout.minimumWidth
• Layout.minimumHeight
• Layout.preferredWidth
• Layout.preferredHeight
• Layout.maximumWidth
• Layout.maximumHeight
• Layout.fillWidth
• Layout.fillHeight
• Layout.alignment

Подробнее о присоединенных свойствах см. здесь.

См. также RowLayout, ColumnLayout и Сетка.

Документация по свойствам

columnSpacing : вещественное

Это свойство хранит интервал между столбцами. Значение по умолчанию равно 5.

columns : целое

Это свойство хранит предел столбцов для позиционирования элементов, если flow равно GridLayout.LeftToRight. Значение по умолчанию — нет ограничений.

flow : перечисление

Это свойство хранит направление потока элементов, у которых нет явного заданного положения ячейки. Оно используется вместе со свойством columns или rows, где они указывают, когда поток сбрасывается на следующую строку или столбец соответственно.

Возможные значения:

• GridLayout.СлеваНаправо (по умолчанию) - Элементы размещаются рядом, затем переходят на следующую строку.
• GridLayout.СверхуВниз - Элементы размещаются рядом сверху вниз, затем переходят на следующий столбец.

См. также rows и columns.

layoutDirection : перечисление

Это свойство хранит направление макета сетки — оно определяет, размещаются ли элементы слева направо или справа налево. Если указано Qt.RightToLeft, элементы, выровненные по левому краю, будут выровнены по правому краю, а элементы, выровненные по правому краю, — по левому.

Возможные значения:

• Qt.СлеваНаправо (по умолчанию) - Элементы размещаются слева направо.
• Qt.СправаНалево - Элементы размещаются справа налево.

Это свойство QML было введено в QtQuick.Layouts 1.1.

См. также RowLayout::layoutDirection и ColumnLayout::layoutDirection.

rowSpacing : вещественное

Это свойство хранит интервал между строками. Значение по умолчанию равно 5.

rows : целое

Это свойство хранит предел строк для позиционирования элементов, если flow равно GridLayout.TopToBottom. Значение по умолчанию — нет ограничений.