Тип 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 : вещественное

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

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

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

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

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

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

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

Это свойство содержит layoutDirection строки.

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

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

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

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

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

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

move : Переход

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

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

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

Примечание: В Qt Quick 1 этот переход применялся ко всем элементам, которые были частью позиционера в момент его создания. Начиная с QtQuick 2 и далее, позиционеры применяют переход populate к этим элементам вместо этого.

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

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

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

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

populate : Переход

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

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

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

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

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

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

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

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

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

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

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

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

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

positioningComplete()

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

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

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

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

forceLayout()

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

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

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

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