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

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

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

Эта документация была добавлена в Qt 5.6.

add : Переход

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

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

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

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

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

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

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

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

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

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.