Тип QML Flow

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

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

Свойства

• add : Transition
• bottomPadding : вещественный
• effectiveLayoutDirection : перечисление
• flow : перечисление
• layoutDirection : перечисление
• leftPadding : вещественный
• move : Transition
• padding : вещественный
• populate : Transition
• 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 и других связанных типах размещения см. в разделе Размещение элементов в Qt Quick.

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

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

add : Transition

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

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

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

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

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

bottomPadding : вещественный

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

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

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

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

При использовании присоединенного свойства LayoutMirroring::enabled для локальных компоновок визуальное направление компоновки компоновщика Grid будет зеркальным. Однако свойство 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 : вещественный

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

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

move : Transition

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

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

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

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

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

padding : вещественный

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

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

populate : Transition

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

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

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

rightPadding : вещественный

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

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

spacing : вещественный

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

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

topPadding : вещественный

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

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

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

positioningComplete()

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

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

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

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

forceLayout()

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

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

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

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