Тип 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 или привязываться к якорям с помощью свойств anchor.

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

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

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

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

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

add : Переход

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

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

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

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

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

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

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

При использовании прикрепленного свойства 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 — Справа налево.

move : Переход

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

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

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

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

populate : Переход

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

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

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

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

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

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

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

[since 5.9] positioningComplete()

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

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

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

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

[since 5.9] forceLayout()

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

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

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

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