Тип Flow QML

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

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

Свойства

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

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

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

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

Эта документация была введена в 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.