Flow QML Type

Aligne ses éléments enfants les uns à côté des autres, en les renvoyant à la ligne si nécessaire. En savoir plus…

• Liste de tous les membres, y compris les membres hérités

Propriétés

• add : Transition
• bottomPadding : real
• effectiveLayoutDirection : enumeration
• flow : enumeration
• layoutDirection : enumeration
• leftPadding : real
• move : Transition
• padding : real
• populate : Transition
• rightPadding : real
• spacing : real
• topPadding : real

Signaux

• positioningComplete()

Méthodes

• void forceLayout()

Description détaillée

L'élément « Flow » positionne ses éléments enfants comme des mots sur une page, en les ajustant pour créer des lignes ou des colonnes d'éléments.

Voici un élément « Flow » contenant divers éléments d'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 }
    }

L’élément Flow positionne automatiquement les éléments enfants de type « Text » côte à côte, en les ajustant si nécessaire :

Si un élément au sein d’un « Flow » n’est pas de type « visible », ou s’il a une largeur ou une hauteur égale à 0, cet élément ne sera pas mis en page et ne sera pas visible au sein du « Flow ». De plus, étant donné qu’un « Flow » positionne automatiquement ses éléments enfants, un élément enfant au sein d’un « Flow » ne doit pas définir ses positions « x » ou « y », ni s’ancrer à l’aide de l’une des propriétés « anchor ».

Pour plus d’informations sur l’utilisation de Flow et d’autres types de positionneurs associés, consultez la section « Positionneurs d’éléments ».

Voir également Column, Row, Grid, Positioner et Qt Quick Exemples - Positionneurs.

Documentation sur les propriétés

add : Transition

Cette propriété définit la transition à appliquer aux éléments ajoutés à ce positionneur. Pour un positionneur, cela s'applique aux :

• Les éléments créés ou dont le parent a été modifié pour devenir un enfant du positionneur après la création de ce dernier
• Les éléments enfants dont la propriété ` Item::visible ` passe de `false` à `true`, et qui sont donc désormais visibles

La transition peut utiliser la propriété ` ViewTransition ` pour accéder à plus de détails sur l’élément en cours d’ajout. Consultez la documentation « ViewTransition » pour plus de détails et d’exemples sur l’utilisation de ces transitions.

Voir également populate, ViewTransition et Qt Quick Exemples - Positionneurs.

Ces propriétés définissent le remplissage autour du contenu.

effectiveLayoutDirection : enumeration [read-only]

Cette propriété définit la direction de mise en page effective du flux.

Lorsque vous utilisez la propriété associée LayoutMirroring::enabled pour les mises en page locales, la direction visuelle de la mise en page du positionneur de grille sera inversée. Cependant, la propriété layoutDirection restera inchangée.

Voir également Flow::layoutDirection et LayoutMirroring.

flow : enumeration

Cette propriété détermine le flux de la mise en page.

Les valeurs possibles sont :

• Flow.LeftToRight (par défaut) : les éléments sont positionnés les uns à côté des autres selon l'layoutDirection, jusqu'à ce que la largeur du flux soit dépassée, puis ils sont reportés sur la ligne suivante.
• Flow.TopToBottom : les éléments sont positionnés les uns à côté des autres de haut en bas jusqu'à ce que la hauteur du flux soit dépassée, puis ils sont reportés sur la colonne suivante.

layoutDirection : enumeration

Cette propriété définit le sens de mise en page.

Les valeurs possibles sont :

• Qt.LeftToRight (par défaut) : les éléments sont positionnés de haut en bas et de gauche à droite. Le sens de défilement dépend de la propriété Flow::flow.
• Qt.RightToLeft : les éléments sont positionnés de haut en bas et de droite à gauche. Le sens de défilement dépend de la propriété ` Flow::flow `.

Voir également Grid::layoutDirection et Row::layoutDirection.

move : Transition

Cette propriété définit la durée de la transition pour les éléments qui se sont déplacés au sein du positionneur. Pour un positionneur, cela s'applique aux :

• les éléments enfants qui se déplacent lorsqu'ils sont déplacés en raison de l'ajout, de la suppression ou du réagencement d'autres éléments dans le positionneur
• Les éléments enfants qui sont repositionnés en raison du redimensionnement d’autres éléments dans le positionneur

La transition peut utiliser la propriété ` ViewTransition ` pour accéder à plus de détails sur l’élément en cours de déplacement. Notez toutefois que pour cette transition de déplacement, les listes ` ViewTransition.targetIndexes` et ` ViewTransition.targetItems` ne sont définies que lorsque cette transition est déclenchée par l’ajout d’autres éléments dans le positionneur ; dans les autres cas, ces listes seront vides. Consultez la documentation « ViewTransition » pour plus de détails et d’exemples sur l’utilisation de ces transitions.

Voir également add, populate, ViewTransition et Qt Quick Exemples - Positionneurs.

populate : Transition

Cette propriété contient la transition à exécuter pour les éléments faisant partie de ce positionneur au moment de sa création. La transition est exécutée lors de la création initiale du positionneur.

La transition peut utiliser la propriété ViewTransition pour accéder à davantage de détails sur l’élément en cours d’ajout. Consultez la documentation ViewTransition pour plus de détails et d’exemples sur l’utilisation de ces transitions.

Voir également add, ViewTransition et Qt Quick Exemples - Positionneurs.

spacing : real

L'espacement correspond à la distance en pixels laissée libre entre chaque élément adjacent ; sa valeur par défaut est 0.

Voir également Grid::spacing.

Documentation Signal

positioningComplete()

Ce signal est émis lorsque le positionnement est terminé.

Documentation de la méthode

void forceLayout()

En règle générale, Flow positionne ses éléments enfants une fois par image. Cela signifie qu'au sein des blocs de script, il est possible que les éléments enfants sous-jacents aient changé, mais que Flow n'ait pas encore été mis à jour en conséquence.

Cette méthode force le Flow à réagir immédiatement à tout changement en attente au niveau de ses enfants.

Remarque: en règle générale, les méthodes ne doivent être appelées qu’une fois que le composant a terminé son exécution.