Тип Flow QML

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

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

Свойства

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

Сигналы

• positioningComplete()

Методы

• forceLayout()

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

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

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

    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 автоматически размещает дочерние элементы Текст рядом друг с другом, с переходом на новую строку по мере необходимости:

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

Дополнительную информацию о использовании 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.

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

positioningComplete()

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

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

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

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

forceLayout()

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

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

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

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