Flow QML Type

Positionne ses enfants côte à côte, en les enveloppant si nécessaire. Plus d'informations...

• 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 enveloppant pour créer des lignes ou des colonnes d'éléments.

Voici un flux qui contient plusieurs éléments 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 Text côte à côte, en les enveloppant si nécessaire :

Si un élément d'un flux n'est pas visible, ou si sa largeur ou sa hauteur est égale à 0, l'élément ne sera pas disposé et ne sera pas visible dans le flux. De même, étant donné qu'un flux positionne automatiquement ses enfants, un élément enfant au sein d'un flux 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 des flux et d'autres types de positionneurs, voir Positionneurs d'éléments.

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

Documentation sur les propriétés

add : Transition

Cette propriété contient la transition à exécuter pour les éléments qui sont ajoutés à ce positionneur. Pour un positionneur, cela s'applique aux éléments suivants

• aux éléments qui sont créés ou reparentés en tant qu'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 qui est ajouté. Voir la documentation de ViewTransition pour plus de détails et d'exemples sur l'utilisation de ces transitions.

Voir aussi 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é indique la direction effective de la disposition du flux.

Lors de l'utilisation de la propriété jointe LayoutMirroring::enabled pour les mises en page locales, la direction de la mise en page visuelle du positionneur de grille sera reflétée. Cependant, la propriété layoutDirection restera inchangée.

Voir également Flow::layoutDirection et LayoutMirroring.

flow : enumeration

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

Les valeurs possibles sont les suivantes :

• Flow.LeftToRight (par défaut) - Les éléments sont positionnés les uns à côté des autres conformément à layoutDirection jusqu'à ce que la largeur du flux soit dépassée, puis ils passent à 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 passent à la colonne suivante.

layoutDirection : enumeration

Cette propriété indique la direction de la mise en page.

Les valeurs possibles sont les suivantes :

• Qt.LeftToRight (par défaut) - Les éléments sont positionnés de haut en bas et de gauche à droite. La direction du flux dépend de la propriété Flow::flow.
• Qt.RightToLeft - Les éléments sont positionnés de haut en bas et de droite à gauche. La direction du flux dépend de la propriété Flow::flow.

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

move : Transition

Cette propriété définit la transition à exécuter pour les éléments qui se sont déplacés dans le positionneur. Pour un positionneur, cela s'applique aux éléments suivants

• aux éléments enfants qui se déplacent suite à l'ajout, à la suppression ou à la réorganisation 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 qui est déplacé. 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. Voir la documentation de ViewTransition pour plus de détails et d'exemples sur l'utilisation de ces transitions.

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

populate : Transition

Cette propriété définit la transition à exécuter pour les éléments qui font partie de ce positionneur au moment de sa création. La transition est exécutée lors de la première création du positionneur.

La transition peut utiliser la propriété ViewTransition pour accéder à plus de détails sur l'élément qui est ajouté. Voir la documentation ViewTransition pour plus de détails et d'exemples sur l'utilisation de ces transitions.

Voir aussi add, ViewTransition, et Qt Quick Exemples - Positionneurs.

spacing : real

l'espacement est la quantité de pixels laissés vides entre chaque élément adjacent ; la valeur par défaut est 0.

Voir également Grid::spacing.

Documentation sur les signaux

positioningComplete()

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

Documentation de la méthode

void forceLayout()

Le flux positionne généralement ses enfants une fois par image. Cela signifie qu'à l'intérieur des blocs de script, il est possible que les enfants sous-jacents aient changé, mais que le flux n'ait pas encore été mis à jour en conséquence.

Cette méthode oblige le flux à réagir immédiatement à toute modification en cours de ses enfants.

Remarque: en règle générale, les méthodes ne doivent être appelées qu'une fois le composant terminé.