Тип 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 или горизонтально закреплять себя с помощью якорей x, left, right, anchors.horizontalCenter, fill или centerIn. Если вам необходимо выполнить эти действия, рассмотрите возможность позиционирования элементов без использования Row.

Обратите внимание, что элементы в Row могут использовать присоединённое свойство Positioner для получения дополнительной информации о их расположении в Row.

Дополнительную информацию об использовании Row и других связанных типах позиционеров см. в разделе Позиционеры элементов.

См. также Column, Grid, Flow, Positioner, RowLayout и Примеры Qt Quick — Позиционеры.

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

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

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

Эта документация была введена в 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.