LayoutMirroring QML Type (Uncreatable)

레이아웃 동작을 반영하는 데 사용되는 속성. 더 보기...

참고: 이 타입은 생성할 수 없는 타입입니다. QML에서 인스턴스화할 수 없습니다.

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

속성

• childrenInherit : bool
• enabled : bool

상세 설명

LayoutMirroring 부착 유형은 항목 앵커, 포지셔너 유형(예: Row 및 Grid) 및 뷰(예: GridView 및 horizontal 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 및 기타 관련 기능을 사용하여 애플리케이션에 오른쪽에서 왼쪽으로(RTL) 지원을 구현하는 방법에 대한 자세한 내용은 ‘오른쪽에서 왼쪽으로(RTL) 사용자 인터페이스’를 참조하십시오.

속성 설명서

childrenInherit : bool

이 속성은 해당 항목의 ‘ LayoutMirroring.enabled ’ 값이 자식 항목에 상속되는지 여부를 나타냅니다.

기본값은 false입니다.

enabled : bool

이 속성은 항목의 레이아웃이 수평으로 대칭 처리되는지 여부를 결정합니다. 이 속성을 true로 설정하면 앵커 설정이 수평 방향으로 반전되어, 왼쪽 앵커는 오른쪽으로, 오른쪽 앵커는 왼쪽으로 바뀝니다. 포지셔너 유형(예: Row 및 Grid)과 뷰 유형(예: GridView 및 ListView)의 경우, 항목의 수평 레이아웃 방향도 대칭 처리됩니다.

기본값은 false입니다.