Тип QML Flow

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

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

Свойства

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

Сигналы

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

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

add : Переход

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

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

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

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

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

bottomPadding : вещественное

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

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

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 - Справа налево.

leftPadding : вещественное

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

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

move : Переход

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

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

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

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

padding : вещественное

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

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

populate : Переход

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

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

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

rightPadding : вещественное

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

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

spacing : вещественное

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

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

topPadding : вещественное

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

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

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

positioningComplete()

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

Соответствующий обработчик onPositioningComplete.

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

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

forceLayout()

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

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

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

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