En esta página

LayoutMirroring QML Type (Uncreatable)

Propiedad utilizada para reflejar el comportamiento del diseño. Más información...

Import Statement: import QtQuick

Nota: Se trata de un tipo no creable. No se puede instanciar en QML.

Propiedades

Descripción detallada

El tipo de acoplamiento «LayoutMirroring» se utiliza para reflejar horizontalmente los anclajes de los elementos, los tipos de posicionador (como « Row » y « Grid ») y las vistas (como « GridView » y « ListView »). El reflejo es un cambio visual: los anclajes de la izquierda se convierten en anclajes de la derecha, y los tipos de posicionador como « Grid » y « Row » invierten la disposición horizontal de los elementos secundarios.

El reflejo se habilita para un elemento estableciendo la propiedad enabled en «true». Por defecto, esto solo afecta al propio elemento; al establecer la propiedad childrenInherit en «true», el comportamiento de reflejo se propaga también a todos los elementos hijos. Si no se ha definido el tipo de acoplamiento LayoutMirroring para un elemento, el reflejo no se habilita.

Nota: Desde Qt 5.8, ` LayoutMirroring ` puede vincularse a un ` Window`. En la práctica, equivale a vincular ` LayoutMirroring ` al ` contentItem` de la ventana.

El siguiente ejemplo muestra el efecto del reflejo. El Row que aparece a continuación está especificado como anclado a la izquierda de su elemento padre. Sin embargo, dado que se ha habilitado el reflejo, el anclaje se invierte horizontalmente y ahora queda anclado a la derecha. Además, dado que los elementos de una « Row » se colocan de izquierda a derecha de forma predeterminada, ahora se colocan de derecha a izquierda, tal y como se muestra en la numeración y la opacidad de los elementos:

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

Fila con elementos numerados del 5 al 1, alineados de derecha a izquierda, que muestra el diseño simétrico

El reflejo de diseño resulta útil cuando es necesario admitir versiones de diseño de izquierda a derecha y de derecha a izquierda de una aplicación para dirigirse a distintas áreas lingüísticas. La propiedad childrenInherit permite aplicar el reflejo de diseño sin tener que configurar manualmente el diseño de cada elemento de una aplicación. Sin embargo, hay que tener en cuenta que el reflejo no afecta a ningún posicionamiento definido por el valor de coordenadas de « Item » x, por lo que, incluso con el reflejo activado, a menudo será necesario aplicar algunas correcciones de diseño para adaptarse a la dirección de diseño deseada. Además, puede ser necesario desactivar el reflejo de elementos secundarios concretos (estableciendo LayoutMirroring.enabled en «false» para dichos elementos) si el reflejo no es el comportamiento deseado o si el elemento secundario ya implementa el reflejo de alguna forma personalizada.

Para establecer la dirección de diseño basándose en la dirección de diseño predeterminada de la aplicación, utilice el siguiente código:

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

Consulte «Interfaces de usuario de derecha a izquierda» para obtener más detalles sobre el uso de ` LayoutMirroring ` y otras características relacionadas para implementar la compatibilidad de derecha a izquierda en una aplicación.

Documentación de la propiedad

childrenInherit : bool

Esta propiedad determina si el valor de « LayoutMirroring.enabled » de este elemento se hereda en sus elementos secundarios.

El valor por defecto es «false».

enabled : bool

Esta propiedad determina si la disposición del elemento se refleja horizontalmente. Si se establece en «true», se invierten horizontalmente los ajustes de anclaje, de modo que los anclajes de la izquierda pasan a la derecha y los de la derecha, a la izquierda. Para los tipos de posicionador (como Row y Grid) y los tipos de vista (como GridView y ListView), esto también refleja la dirección de disposición horizontal del elemento.

El valor por defecto es «false».

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.