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