LayoutMirroring QML Type

Eigenschaft zur Spiegelung des Layoutverhaltens. Mehr...

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

• childrenInherit : bool
• enabled : bool

Detaillierte Beschreibung

Die angehängte Eigenschaft LayoutMirroring dient zur horizontalen Spiegelung von Elementankern, Positionierertypen (wie Row und Grid) und Ansichten (wie GridView und horizontal ListView). Die Spiegelung ist eine visuelle Änderung: Linke Anker werden zu rechten Ankern, und Positionierer-Typen wie Grid und Row kehren das horizontale Layout der untergeordneten Elemente um.

Die Spiegelung wird für ein Element aktiviert, indem die Eigenschaft enabled auf true gesetzt wird. Standardmäßig wirkt sich dies nur auf das Element selbst aus; wird die Eigenschaft childrenInherit auf true gesetzt, wird das Spiegelungsverhalten auch auf alle untergeordneten Elemente übertragen. Wenn die Eigenschaft LayoutMirroring attached nicht für ein Element definiert wurde, ist die Spiegelung nicht aktiviert.

Das folgende Beispiel zeigt die Spiegelung in Aktion. Das folgende Row ist links von seinem Elternteil verankert. Da jedoch die Spiegelung aktiviert wurde, wird die Verankerung horizontal umgedreht und ist nun rechts verankert. Da die Elemente in Row standardmäßig von links nach rechts positioniert sind, werden sie nun von rechts nach links positioniert, was sich in der Nummerierung und der Deckkraft der Elemente widerspiegelt:

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
                }
            }
        }
    }
}

Die Layout-Spiegelung ist nützlich, wenn es notwendig ist, sowohl Links-nach-Rechts- als auch Rechts-nach-Links-Layoutversionen einer Anwendung zu unterstützen, um verschiedene Sprachräume anzusprechen. Die Eigenschaft childrenInherit ermöglicht die Anwendung der Layoutspiegelung, ohne dass die Layoutkonfigurationen für jedes Element in einer Anwendung manuell festgelegt werden müssen. Beachten Sie jedoch, dass sich die Spiegelung nicht auf die Positionierung auswirkt, die durch den Item x Koordinatenwert definiert ist, so dass es selbst bei aktivierter Spiegelung oft notwendig sein wird, einige Layoutkorrekturen vorzunehmen, um die gewünschte Layoutrichtung zu unterstützen. Außerdem kann es notwendig sein, die Spiegelung einzelner untergeordneter Elemente zu deaktivieren (indem Sie LayoutMirroring.enabled für solche Elemente auf false setzen), wenn die Spiegelung nicht das gewünschte Verhalten ist oder wenn das untergeordnete Element die Spiegelung bereits auf eine eigene Art und Weise implementiert.

Um die Layoutrichtung basierend auf der Standard-Layoutrichtung der Anwendung festzulegen, verwenden Sie den folgenden Code:

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

Weitere Einzelheiten zur Verwendung von LayoutMirroring und anderen verwandten Funktionen zur Implementierung von Rechts-nach-Links-Unterstützung für eine Anwendung finden Sie unter Rechts-nach-Links-Benutzerschnittstellen.

Eigenschaft Dokumentation