Тип QML GridLayout

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

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

Свойства

• columnSpacing : real
• columns : int
• flow : перечисление
• layoutDirection : перечисление
• rowSpacing : real
• rows : int

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

Если 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
• Layout.margins
• Layout.leftMargin
• Layout.rightMargin
• Layout.topMargin
• Layout.bottomMargin

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

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

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

columnSpacing : real

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

columns : int

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

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

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

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

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

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

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

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

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

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

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

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

rowSpacing : real

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

rows : int

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