LayoutMirroring QML Type

Propriété utilisée pour refléter le comportement de la mise en page. Plus d'informations...

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

Propriétés

• childrenInherit : bool
• enabled : bool

Description détaillée

Le type d'attachement LayoutMirroring est utilisé pour refléter horizontalement les ancres des éléments, les types de positionneurs (tels que Row et Grid) et les vues (telles que GridView et ListView horizontal). Le miroir est un changement visuel : les ancres de gauche deviennent des ancres de droite et les positionneurs tels que Grid et Row inversent la disposition horizontale des éléments enfants.

L'effet miroir est activé pour un élément en définissant la propriété enabled sur true. Par défaut, cela n'affecte que l'élément lui-même ; la définition de la propriété childrenInherit à true propage le comportement de mise en miroir à tous les éléments enfants également. Si le type d'attachement LayoutMirroring n'a pas été défini pour un élément, la mise en miroir n'est pas activée.

L'exemple suivant montre la mise en miroir en action. Le site Row ci-dessous est spécifié comme étant ancré à la gauche de son parent. Cependant, comme l'effet miroir a été activé, l'ancrage est inversé horizontalement et il est maintenant ancré à droite. En outre, comme les éléments d'un site Row sont positionnés par défaut de gauche à droite, ils sont désormais positionnés de droite à gauche, comme le montrent la numérotation et l'opacité des éléments :

import QtQuick

Rectangle {
    LayoutMirroring.enabled: true
    LayoutMirroring.childrenInherit: true

    width: 300; height: 50
    color: "yellow"
    border.width: 1

    Row {
        anchors { left: parent.left; margins: 5 }
        y: 5; spacing: 5

        Repeater {
            model: 5

            Rectangle {
                color: "red"
                opacity: (5 - index) / 5
                width: 40; height: 40

                Text {
                    text: index + 1
                    anchors.centerIn: parent
                }
            }
        }
    }
}

La mise en miroir de la mise en page est utile lorsqu'il est nécessaire de prendre en charge les versions de mise en page de gauche à droite et de droite à gauche d'une application pour cibler différentes zones linguistiques. La propriété childrenInherit permet d'appliquer la mise en miroir de la présentation sans avoir à définir manuellement des configurations de présentation pour chaque élément d'une application. N'oubliez pas, cependant, que la mise en miroir n'affecte pas le positionnement défini par la valeur de coordonnées Item x . Par conséquent, même si la mise en miroir est activée, il sera souvent nécessaire d'appliquer certaines corrections de mise en page pour prendre en charge la direction de mise en page souhaitée. Il peut également être nécessaire de désactiver la mise en miroir d'éléments enfants individuels (en définissant LayoutMirroring.enabled sur false pour ces éléments) si la mise en miroir n'est pas le comportement souhaité, ou si l'élément enfant implémente déjà la mise en miroir d'une manière personnalisée.

Pour définir la direction de la mise en page en fonction de la direction de la mise en page par défaut de l'application, utilisez le code suivant :

LayoutMirroring.enabled: Qt.application.layoutDirection === Qt.RightToLeft

Voir Interfaces utilisateur droite-gauche pour plus de détails sur l'utilisation de LayoutMirroring et d'autres fonctionnalités connexes pour mettre en œuvre la prise en charge droite-gauche d'une application.

Documentation sur les propriétés

childrenInherit : bool

Cette propriété indique si la valeur LayoutMirroring.enabled de cet élément est héritée par ses enfants.

La valeur par défaut est false.

enabled : bool

Cette propriété indique si la mise en page de l'élément est reflétée horizontalement. La définition de cette propriété à true inverse horizontalement les paramètres d'ancrage, de sorte que les ancres de gauche deviennent des ancres de droite, et les ancres de droite deviennent des ancres de gauche. Pour les types de positionneurs (tels que Row et Grid) et les types de vues (tels que GridView et ListView), cette propriété reflète également la direction de la mise en page horizontale de l'élément.

La valeur par défaut est false.