Тип QML Row

Располагает своих дочерних элементов в строке. Подробнее...

• Список всех членов, включая унаследованные

Свойства

• add : Переход
• bottomPadding : real
• effectiveLayoutDirection : перечисление
• layoutDirection : перечисление
• leftPadding : real
• move : Переход
• padding : real
• populate : Переход
• rightPadding : real
• spacing : real
• topPadding : real

Сигналы

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

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

add : Переход

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

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

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

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

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

bottomPadding : real

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

Это свойство было введено в Qt 5.6.

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

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

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

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

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

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

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

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

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

leftPadding : real

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

Это свойство было введено в Qt 5.6.

move : Переход

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

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

Переход может использовать свойство ViewTransition для доступа к дополнительным данным об перемещаемом элементе. Обратите внимание, что для этого перехода перемещения списки ViewTransition.targetIndexes и ViewTransition.targetItems устанавливаются только при запуске этого перехода из-за добавления других элементов в позиционер; в других случаях эти списки будут пустыми. Более подробную информацию и примеры использования этих переходов см. в документации по ViewTransition.

Примечание: В Qt Quick 1 этот переход применялся ко всем элементам, которые входили в состав позиционера во время его создания. Начиная с QtQuick 2, позиционеры вместо этого применяют переход populate к этим элементам.

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

padding : real

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

Это свойство было введено в Qt 5.6.

populate : Переход

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

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

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

rightPadding : real

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

Это свойство было введено в Qt 5.6.

spacing : real

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

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

topPadding : real

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

Это свойство было введено в Qt 5.6.

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

positioningComplete()

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

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

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

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

forceLayout()

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

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

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

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