Row QML Type

Positionne ses enfants dans une rangée. Plus d'informations...

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

Propriétés

• add : Transition
• bottomPadding : real
• effectiveLayoutDirection : 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

Row est un type qui positionne ses éléments enfants sur une seule ligne. Il peut être utilisé comme un moyen pratique de positionner horizontalement une série d'éléments sans utiliser d'ancres.

Voici une rangée qui contient trois rectangles de tailles différentes :

import QtQuick

Row {
    spacing: 2
    Rectangle { color: "red"; width: 50; height: 50 }
    Rectangle { color: "green"; width: 20; height: 50 }
    Rectangle { color: "blue"; width: 50; height: 20 }
}

La rangée positionne automatiquement ces éléments dans une formation horizontale, comme ceci :

Si un élément d'une rangée 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 la rangée. De même, étant donné qu'une rangée positionne automatiquement ses enfants horizontalement, un élément enfant à l'intérieur d'une rangée ne doit pas définir sa position x ou s'ancrer horizontalement à l'aide des ancres left, right, anchors.horizontalCenter, fill ou centerIn. Si vous devez effectuer ces actions, envisagez de positionner les éléments sans utiliser de rangée.

Notez que les éléments d'une rangée peuvent utiliser la propriété Positioner attached pour obtenir davantage d'informations sur leur position dans la rangée.

Pour plus d'informations sur l'utilisation de la rangée et d'autres types de positionneurs, voir Positionneurs d'éléments.

Voir aussi Column, Grid, Flow, Positioner, RowLayout, 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 de la ligne.

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 ligne sera reflétée. Cependant, la propriété layoutDirection restera inchangée.

Voir également Row::layoutDirection et LayoutMirroring.

layoutDirection : enumeration

Cette propriété indique la direction de la ligne.

Valeurs possibles :

Voir également Grid::layoutDirection et Flow::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 les éléments adjacents. L'espacement par défaut est de 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()

La rangée 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 la rangée n'ait pas encore été mise à jour en conséquence.

Cette méthode oblige la rangée à 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é.