Тип 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 для получения дополнительной информации о перемещаемом элементе. Однако обратите внимание, что для этого перехода перемещения списки 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.