Тип 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.

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

positioningComplete()

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

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

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

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

forceLayout()

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

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

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

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