Тип QML LayoutMirroring

Свойство, используемое для отражения поведения макета Подробнее...

• Список всех членов, включая наследуемые

Свойства

• childrenInherit : bool
• enabled : bool

Подробное описание

Присоединённое свойство LayoutMirroring используется для горизонтального отражения якорей элементов, типов позиционеров (таких как Row и Grid) и представлений (таких как GridView и горизонтальный ListView). Отражение — это визуальное изменение: левые якоря становятся правыми, а типы позиционеров, такие как Grid и Row, изменяют горизонтальную компоновку дочерних элементов.

Отражение активируется для элемента, если свойство enabled установлено в true. По умолчанию это влияет только на сам элемент; установка свойства childrenInherit в true распространяет поведение отражения на все дочерние элементы. Если свойство LayoutMirroring не определено для элемента, отражение не активировано.

Следующий пример демонстрирует отражение в действии. Row ниже указан как закреплённый слева от родительского элемента. Однако, поскольку отражение включено, якорь горизонтально инвертируется, и теперь он закреплён справа. Кроме того, поскольку элементы в Row по умолчанию позиционируются слева направо, они теперь позиционируются справа налево, как показано по номерам и непрозрачности элементов:

import QtQuick 2.0

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

Отражение макета полезно, когда необходимо поддерживать как версии макета слева направо, так и справа налево для приложения, ориентированного на разные языковые области. Свойство childrenInherit позволяет применять отражение макета без ручного настройки конфигураций макета для каждого элемента в приложении. Однако имейте в виду, что отражение не влияет на позиционирование, определяемое значением координаты Item x, поэтому даже при включённом отражении часто потребуется внести некоторые исправления в макет, чтобы поддерживать желаемое направление макета. Также может потребоваться отключить отражение отдельных дочерних элементов (путем установки LayoutMirroring.enabled в false для таких элементов), если отражение не нужно или если дочерний элемент уже реализует отражение каким-либо пользовательским способом.

Дополнительные сведения об использовании LayoutMirroring и других связанных функций для реализации поддержки справа налево в приложении см. в разделе Графические интерфейсы справа налево.

Документация по свойствам

childrenInherit : bool

Это свойство указывает, наследуется ли значение LayoutMirroring.enabled для этого элемента его дочерними элементами.

Значение по умолчанию — false.

enabled : bool

Это свойство указывает, зеркально отражается ли горизонтальный макет элемента. Установка этого значения в true горизонтально инвертирует настройки якорей таким образом, что левые якоря становятся правыми, а правые — левыми. Для типов позиционеров (таких как Row и Grid) и типов представлений (таких как GridView и ListView) это также отражает направление горизонтального макета элемента.

Значение по умолчанию — false.