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

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

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

Эта документация была добавлена в Qt 5.6.

add : Переход

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

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

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

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

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

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

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

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

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.