Тип QML Row

Размещает своих потомков в строке. Подробнее...

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

Свойства

• add : Переход
• bottomPadding : вещественное
• effectiveLayoutDirection : перечисление
• layoutDirection : перечисление
• leftPadding : вещественное
• move : Переход
• padding : вещественное
• populate : Переход
• rightPadding : вещественное
• spacing : вещественное
• topPadding : вещественное

Сигналы

• positioningComplete()

Методы

• forceLayout()

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

Row — это тип, который размещает свои дочерние элементы вдоль одной строки. Он может использоваться в качестве удобного способа горизонтального размещения ряда элементов без использования якорей.

Ниже приведён пример Row, содержащий три прямоугольника различных размеров:

import QtQuick 2.0

Row {
    spacing: 2
    Rectangle { color: "red"; width: 50; height: 50 }
    Rectangle { color: "green"; width: 20; height: 50 }
    Rectangle { color: "blue"; width: 50; height: 20 }
}

Row автоматически размещает эти элементы в горизонтальном формате, как показано ниже:

Если элемент внутри Row не видимый, или если у него ширина или высота равны 0, элемент не будет выложен и не будет виден в строке. Кроме того, поскольку Row автоматически размещает свои дочерние элементы горизонтально, дочерний элемент внутри Row не должен устанавливать своё положение x или горизонтально привязываться с помощью якорей left, right, anchors.horizontalCenter, fill или centerIn. Если вам необходимо выполнить эти действия, рассмотрите размещение элементов без использования Row.

Обратите внимание, что элементы в Row могут использовать свойство Positioner, чтобы получить больше информации о своём положении внутри Row.

Для получения более подробной информации об использовании Row и других связанных типов позиционеров см. Позиционеры элементов.

См. также Column, Grid, Flow, Positioner, RowLayout и Примеры Qt Quick — Позиционеры.

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

add : Переход

Это свойство содержит переход, который должен быть выполнен для элементов, которые добавляются в этот позиционер. Для позиционера это относится к:

• Элементы, которые создаются или переродируются как дочерние элементы позиционера после создания позиционера
• Дочерние элементы, которые изменяют своё свойство Item::visible со значения false на true и, таким образом, становятся видимыми

Переход может использовать свойство ViewTransition, чтобы получить больше информации об добавляемом элементе. Подробнее и примеры использования этих переходов см. в документации к ViewTransition.

Примечание: Этот переход не применяется к элементам, которые уже являются частью позиционера в момент его создания. В этом случае применяется переход populate.

См. также populate, ViewTransition и Примеры Qt Quick — Позиционеры.

bottomPadding : вещественное

Эти свойства содержат отступы вокруг содержимого.

Это свойство было введено в Qt 5.6.

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

Это свойство содержит эффективное направление выравнивания строк.

При использовании присоединенного свойства LayoutMirroring::enabled для локальных выравниваний, визуальное направление выравнивания позиционера строк будет зеркальным. Однако свойство layoutDirection останется неизменным.

См. также Row::layoutDirection и LayoutMirroring.

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

Это свойство содержит направление выравнивания строк.

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

• Qt.LeftToRight (по умолчанию) — элементы выравниваются слева направо. Если ширина строки задана явно, левый якорь остаётся слева от строки.
• Qt.RightToLeft — элементы выравниваются справа налево. Если ширина строки задана явно, правый якорь остаётся справа от строки.

См. также Grid::layoutDirection, Flow::layoutDirection и Примеры Qt Quick — Справа налево.

leftPadding : вещественное

Эти свойства содержат отступы вокруг содержимого.

Это свойство было введено в Qt 5.6.

move : Переход

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

• Дочерние элементы, которые перемещаются, когда они смещаются из-за добавления, удаления или перестановки других элементов в позиционере
• Дочерние элементы, которые перемещаются из-за изменения размера других элементов в позиционере

Переход может использовать свойство ViewTransition, чтобы получить больше информации об перемещаемом элементе. Однако обратите внимание, что для этого перехода перемещения списки ViewTransition.targetIndexes и ViewTransition.targetItems устанавливаются только тогда, когда этот переход инициируется добавлением других элементов в позиционер; в других случаях эти списки будут пусты. Подробнее и примеры использования этих переходов см. в документации к ViewTransition.

См. также add, populate, ViewTransition и Примеры Qt Quick — Позиционеры.

padding : вещественное

Эти свойства содержат отступы вокруг содержимого.

Это свойство было введено в Qt 5.6.

populate : Переход

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

Переход может использовать свойство ViewTransition, чтобы получить больше информации об добавляемом элементе. Подробнее и примеры использования этих переходов см. в документации к ViewTransition.

См. также add, ViewTransition и Примеры Qt Quick — Позиционеры.

rightPadding : вещественное

Эти свойства содержат отступы вокруг содержимого.

Это свойство было введено в Qt 5.6.

spacing : вещественное

Отступ — это количество пикселей, оставляемых пустыми между смежными элементами. По умолчанию отступ равен 0.

См. также Grid::spacing.

topPadding : вещественное

Эти свойства содержат отступы вокруг содержимого.

Это свойство было введено в Qt 5.6.

Документация по сигналам

positioningComplete()

Этот сигнал излучается при завершении позиционирования.

Соответствующий обработчик — onPositioningComplete.

Этот сигнал был введён в Qt 5.9.

Документация по методам

forceLayout()

Row обычно позиционирует свои дочерние элементы один раз за кадр. Это означает, что внутри блоков сценария возможно изменение дочерних элементов, но Row ещё не был соответствующим образом обновлён.

Этот метод заставляет Row немедленно реагировать на любые необработанные изменения в его дочерних элементах.

Примечание: методы, как правило, должны вызываться только после завершения компонента.

Этот метод был введён в Qt 5.9.