LayoutMirroring QML Type (Uncreatable)

Propriété utilisée pour reproduire le comportement de la mise en page. En savoir plus...

Remarque : il s'agit d'un type non instanciable. Il ne peut pas être instancié en QML.

• 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 inverser horizontalement les ancrages d'éléments, les types de positionneurs (tels que Row et Grid) et les vues (telles que GridView et horizontal ListView). L'inversion est une modification visuelle : les ancrages de gauche deviennent des ancrages de droite, et les types de positionneurs tels que Grid et Row inversent la disposition horizontale des éléments enfants.

Pour activer la mise en miroir d’un élément, il suffit de définir la propriété ` enabled ` sur `true`. Par défaut, cela n’affecte que l’élément lui-même ; définir la propriété ` childrenInherit ` sur `true` étend également le comportement de mise en miroir à tous les éléments enfants. Si le type d’attache ` LayoutMirroring ` n’a pas été défini pour un élément, la mise en miroir n’est pas activée.

L'exemple suivant illustre le fonctionnement de la mise en miroir. L'Row ci-dessous est défini comme étant ancré à gauche de son parent. Cependant, la mise en miroir étant activée, l'ancrage est inversé horizontalement et il est désormais ancré à droite. De plus, comme les éléments d’une Row sont positionnés de gauche à droite par défaut, 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 à la fois les versions de mise en page de gauche à droite et de droite à gauche d’une application afin de cibler différentes zones linguistiques. La propriété childrenInherit permet d’appliquer la mise en miroir de la mise en page sans avoir à définir manuellement les configurations de mise en page pour chaque élément d’une application. Gardez toutefois à l’esprit que la mise en miroir n’affecte pas les positionnements définis par la valeur de coordonnée Item x ; ainsi, même lorsque la mise en miroir est activée, il sera souvent nécessaire d’appliquer quelques corrections de mise en page pour prendre en charge le sens de mise en page souhaité. De plus, il peut s’avérer 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 de manière personnalisée.

Pour définir le sens de mise en page en fonction du sens de mise en page par défaut de l’application, utilisez le code suivant :

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

Consultez la section Interfaces utilisateur de droite à gauche pour plus de détails sur l’utilisation de ` LayoutMirroring ` et d’autres fonctionnalités associées afin de mettre en œuvre la prise en charge de la direction de droite à gauche pour une application.

Documentation sur les propriétés

childrenInherit : bool

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

La valeur par défaut est « false ».

enabled : bool

Cette propriété détermine si la mise en page de l'élément est inversée horizontalement. En définissant cette propriété sur « true », les ancrages sont inversés horizontalement : les ancrages à gauche deviennent des ancrages à droite, et inversement. Pour les types de positionneurs (tels que Row et Grid) et les types de vue (tels que GridView et ListView), cela inverse également le sens horizontal de la mise en page de l'élément.

La valeur par défaut est « false ».