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

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

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

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

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

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

add : Переход

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

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

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

См. также 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 для доступа к дополнительным данным об элементе, который перемещается. Однако обратите внимание, что для этого переходa перемещения списки 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.