LayoutMirroring QML Type

레이아웃 동작을 미러링하는 데 사용되는 속성입니다. 더 보기...

• 상속된 멤버를 포함한 모든 멤버 목록

속성

• childrenInherit : bool
• enabled : bool

상세 설명

레이아웃 미러링 속성은 항목 앵커, 포지셔너 유형(예: Row 및 Grid)과 뷰(예: GridView 및 가로 ListView)를 수평으로 미러링하는 데 사용됩니다. 미러링은 왼쪽 앵커가 오른쪽 앵커가 되고 Grid 및 Row 같은 포지셔너 유형은 하위 항목의 가로 레이아웃을 반전시키는 시각적 변경입니다.

미러링은 enabled 속성을 true로 설정하여 항목에 대해 활성화합니다. 기본적으로 이는 항목 자체에만 영향을 미치며 childrenInherit 속성을 true로 설정하면 모든 하위 항목에도 미러링 동작이 전파됩니다. 항목에 대해 LayoutMirroring 첨부 속성이 정의되지 않은 경우 미러링이 활성화되지 않습니다.

다음 예제는 미러링이 실제로 작동하는 모습을 보여줍니다. 아래의 Row 은 부모 창 왼쪽에 앵커링되도록 지정되어 있습니다. 그러나 미러링이 활성화되었으므로 앵커가 가로로 반전되어 이제 오른쪽에 앵커링됩니다. 또한 Row 의 항목은 기본적으로 왼쪽에서 오른쪽으로 배치되므로 이제 항목의 번호와 불투명도에서 알 수 있듯이 오른쪽에서 왼쪽으로 배치됩니다:

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

레이아웃 미러링은 서로 다른 언어 영역을 대상으로 애플리케이션의 왼쪽에서 오른쪽 및 오른쪽에서 왼쪽 레이아웃 버전을 모두 지원해야 할 때 유용합니다. childrenInherit 속성을 사용하면 애플리케이션의 모든 항목에 대해 레이아웃 구성을 수동으로 설정하지 않고도 레이아웃 미러링을 적용할 수 있습니다. 그러나 미러링은 Item x 좌표 값으로 정의된 위치에는 영향을 주지 않으므로 미러링을 사용하더라도 원하는 레이아웃 방향을 지원하기 위해 일부 레이아웃 수정을 적용해야 하는 경우가 종종 있습니다. 또한 미러링이 원하는 동작이 아니거나 하위 항목이 이미 사용자 정의 방식으로 미러링을 구현하는 경우 개별 하위 항목의 미러링을 비활성화(해당 항목에 대해 LayoutMirroring.enabled 을 false로 설정)해야 할 수도 있습니다.

애플리케이션의 기본 레이아웃 방향 에 따라 레이아웃 방향을 설정하려면 다음 코드를 사용합니다:

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

LayoutMirroring 및 기타 관련 기능을 사용하여 애플리케이션의 오른쪽에서 왼쪽 지원을 구현하는 방법에 대한 자세한 내용은 오른쪽에서 왼쪽 사용자 인터페이스를 참조하세요.

속성 문서