Тип 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
• Layout.margins
• Layout.leftMargin
• Layout.rightMargin
• Layout.topMargin
• Layout.bottomMargin

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

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

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

columnSpacing : вещественный

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

columns : целое

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

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

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

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

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

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

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

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

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

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

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

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

rowSpacing : вещественный

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

rows : целое

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