Тип 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.LeftToRight (по умолчанию) — Элементы позиционируются друг за другом, а затем переходят на следующую строку.
• GridLayout.TopToBottom — Элементы позиционируются друг за другом сверху вниз, а затем переходят на следующий столбец.

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

[since QtQuick.Layouts 1.1] layoutDirection : перечисление

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

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

• Qt.LeftToRight (по умолчанию) — Элементы выстраиваются слева направо.
• Qt.RightToLeft — Элементы выстраиваются справа налево.

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

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

rowSpacing : real

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

rows : int

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