Тип 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 — Позиционеры.

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

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

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

add : Переход

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

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

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

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

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

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

Это свойство хранит эффективное направление компоновки строки.

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

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

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

Это свойство хранит layoutDirection строки.

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

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

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

move : Переход

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

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

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

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

populate : Переход

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

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

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

spacing : вещественное число

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

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

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

[since 5.9] positioningComplete()

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

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

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

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

[since 5.9] forceLayout()

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

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

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

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