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

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

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

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

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

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

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

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

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

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

move : Переход

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

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

populate : Переход

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

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

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

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

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

[since 5.9] positioningComplete()

Этот сигнал излучается, когда размещение завершено.

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

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

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

[since 5.9] forceLayout()

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

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

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

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