Тип QML Flow

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

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

Свойства

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

Сигналы

• positioningComplete()

Методы

• forceLayout()

Подробное описание

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

Ниже представлен элемент Flow, содержащий различные элементы Text:

    Flow {
        anchors.fill: parent
        anchors.margins: 4
        spacing: 10

        Text { text: "Text"; font.pixelSize: 40 }
        Text { text: "items"; font.pixelSize: 40 }
        Text { text: "flowing"; font.pixelSize: 40 }
        Text { text: "inside"; font.pixelSize: 40 }
        Text { text: "a"; font.pixelSize: 40 }
        Text { text: "Flow"; font.pixelSize: 40 }
        Text { text: "item"; font.pixelSize: 40 }
    }

Элемент Flow автоматически размещает дочерние элементы Text рядом, переходя на новую строку по мере необходимости:

Если элемент внутри Flow не видим, или у него ширина или высота равна 0, элемент не будет размещен и не будет виден внутри Flow. Также, поскольку Flow автоматически размещает свои дочерние элементы, дочерний элемент внутри Flow не должен устанавливать свои значения x или y, или закреплять себя с помощью свойств anchors.

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

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

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

add : Переход

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• Flow.LeftToRight (по умолчанию) - Элементы размещаются рядом друг с другом в соответствии с layoutDirection, пока не превысится ширина Flow, затем переходят на следующую строку.
• Flow.TopToBottom - Элементы размещаются друг под другом сверху вниз, пока не превысится высота Flow, затем переходят в следующий столбец.

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

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

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

• Qt.LeftToRight (по умолчанию) - Элементы размещаются сверху вниз и слева направо. Направление потока зависит от свойства Flow::flow.
• Qt.RightToLeft - Элементы размещаются сверху вниз и справа налево. Направление потока зависит от свойства Flow::flow.

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

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

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

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

move : Переход

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

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

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

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

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

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

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

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

populate : Переход

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

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

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

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

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

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

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

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

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

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

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

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

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

positioningComplete()

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

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

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

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

forceLayout()

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

Этот метод заставляет поток немедленно реагировать на любые незавершенные изменения в своих потомках.

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

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