Тип QML GridLayout

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

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

Свойства

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

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

Для более эффективного использования данного типа рекомендуется ознакомиться с общим механизмом модуля Qt Quick Layouts. Дополнительную информацию см. в разделе Обзор Qt Quick Layouts.

При изменении размеров 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, StackLayout, Grid и Обзор Qt Quick Layouts.

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

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. Значение по умолчанию — отсутствие ограничения.