Row QML Type

Aligne ses éléments enfants. En savoir plus...

• 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

Le type « Row » permet de positionner ses éléments enfants sur une seule ligne. Il constitue un moyen pratique de positionner horizontalement une série d'éléments sans utiliser d'ancrages.

Voici une « Row » contenant 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 balise « Row » positionne automatiquement ces éléments horizontalement, comme ceci :

Si un élément d’une Row n’est pas « visible », ou s’il a une largeur ou une hauteur égale à 0, cet élément ne sera pas pris en compte dans la mise en page et ne sera pas visible au sein de la Row. De plus, comme une Row positionne automatiquement ses éléments enfants horizontalement, un élément enfant d’une Row ne doit pas définir sa position « x » ni s’ancrer horizontalement à l’aide des ancrages « left », « right », « anchors.horizontalCenter », « fill » ou « centerIn ». Si vous devez effectuer ces opérations, envisagez de positionner les éléments sans utiliser de ligne.

Notez que les éléments d’une ligne peuvent utiliser la propriété attachée « Positioner » pour accéder à davantage d’informations sur leur position au sein de la ligne.

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

Voir également Column, Grid, Flow, Positioner, RowLayout 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 le sens de mise en page effectif de la ligne.

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

Voir également Row::layoutDirection et LayoutMirroring.

layoutDirection : enumeration

Cette propriété définit la direction d'alignement (layoutDirection) de la ligne.

Valeurs possibles :

Voir également Grid::layoutDirection et Flow::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 à la suite 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 deux éléments adjacents. L'espacement 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, un élément « Row » repositionne ses enfants une fois par image. Cela signifie qu'au sein des blocs de script, il est possible que les enfants sous-jacents aient changé, mais que l'élément « Row » n'ait pas encore été mis à jour en conséquence.

Cette méthode force la ligne à réagir immédiatement à toute modification en attente au niveau de ses éléments 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.