Layout QML Type

GridLayout, RowLayout 또는 ColumnLayout 에 추가된 항목에 대한 첨부 속성을 제공합니다. 더 보기...

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

부속 속성

• alignment : Qt.Alignment
• bottomMargin : real (since QtQuick.Layouts 1.2)
• column : int
• columnSpan : int
• fillHeight : bool
• fillWidth : bool
• horizontalStretchFactor : int (since Qt 6.5)
• leftMargin : real (since QtQuick.Layouts 1.2)
• margins : real (since QtQuick.Layouts 1.2)
• maximumHeight : real
• maximumWidth : real
• minimumHeight : real
• minimumWidth : real
• preferredHeight : real
• preferredWidth : real
• rightMargin : real (since QtQuick.Layouts 1.2)
• row : int
• rowSpan : int
• topMargin : real (since QtQuick.Layouts 1.2)
• useDefaultSizePolicy : enumeration (since 6.8)
• verticalStretchFactor : int (since Qt 6.5)

상세 설명

Layout 유형의 객체가 레이아웃의 자식 요소에 연결되어 해당 항목에 대한 레이아웃 관련 정보를 제공합니다. 연결된 객체의 속성은 레이아웃이 항목을 배열하는 방식에 영향을 미칩니다.

예를 들어, 기본값이 만족스럽지 않은 경우 minimumWidth, preferredWidth 및 maximumWidth 를 지정할 수 있습니다.

레이아웃의 크기가 조정되면 항목의 크기도 커지거나 작아질 수 있습니다. 이 때문에 항목에는 minimum size, preferred size 및 maximum size 속성이 있습니다.

항목에 최소 크기가 명시적으로 지정되지 않은 경우, 크기는 0 로 설정됩니다. 항목에 최대 크기가 명시적으로 지정되지 않은 경우, 크기는 Number.POSITIVE_INFINITY 로 설정됩니다.

레이아웃의 경우, 암시적 최소 및 최대 크기는 레이아웃의 콘텐츠에 따라 달라집니다.

fillWidth 및 fillHeight 속성은 true 또는 false 일 수 있습니다. 이 속성이 false 인 경우, 항목의 크기는 선호 크기로 고정됩니다. 그렇지 않은 경우, 레이아웃의 크기가 조정됨에 따라 항목의 크기는 최소 크기와 최대 크기 사이에서 커지거나 작아집니다. fillWidth (또는 fillHeight)가 true 로 설정된 항목이 여러 개 있는 경우, 레이아웃은 각 항목의 선호 크기 비율에 따라 항목의 크기를 확대하거나 축소합니다.

레이아웃 알고리즘에 대한 자세한 내용은 Qt Quick Layouts 개요를 참조하십시오.

GridLayout, RowLayout 및 ColumnLayout도 참조하십시오 .

부착된 속성 문서

Layout.alignment : Qt.Alignment [attached]

이 속성을 사용하면 항목이 차지하는 셀 내에서 항목의 정렬 방식을 지정할 수 있습니다.

기본값은 ` 0`이며, 이는 ` Qt.AlignVCenter | Qt.AlignLeft`을 의미합니다. 이러한 기본값은 수평 또는 수직 플래그만 지정된 경우에도 적용됩니다. 즉, 수평 플래그만 지정된 경우 기본 수직 플래그는 ` Qt.AlignVCenter`이 되고, 수직 플래그만 지정된 경우 기본 수평 플래그는 ` Qt.AlignLeft`이 됩니다.

유효한 정렬 방식은 다음 플래그들의 조합입니다:

• Qt::AlignLeft
• Qt::AlignHCenter
• Qt::AlignRight
• Qt::AlignTop
• Qt::AlignVCenter
• Qt::AlignBottom
• Qt::AlignBaseline

Layout.bottomMargin : real [attached, since QtQuick.Layouts 1.2]

항목 바깥쪽의 하단 여백을 지정합니다. 값이 설정되지 않은 경우, ` margins`의 값이 사용됩니다.

이 속성은 QtQuick.Layouts 1.2에서 도입되었습니다.

margins도 참조하십시오 .

Layout.column : int [attached]

이 속성을 사용하면 ` GridLayout` 내의 항목의 열 위치를 지정할 수 있습니다.

row 와 이 속성이 모두 설정되지 않은 경우, 해당 항목에 셀을 할당하는 것은 레이아웃에 달려 있습니다.

기본값은 0 입니다.

row 및 columnSpan항목도 참조하십시오 .

Layout.columnSpan : int [attached]

이 속성을 사용하면 GridLayout 내 항목의 열 범위를 지정할 수 있습니다.

기본값은 1 입니다.

rowSpan 및 column항목도 참조하십시오 .

Layout.fillHeight : bool [attached]

이 속성이 ‘ true ’인 경우, 항목은 주어진 제약 조건을 준수하면서 가능한 한 높은 높이를 갖게 됩니다. 속성이 ‘ false ’인 경우, 항목의 높이는 선호 높이로 고정됩니다. 기본값은 항목의 암시적(내장) 크기 정책에 따라 달라집니다.

관련 항목: fillWidth.

Layout.fillWidth : bool [attached]

이 속성이 ‘ true ’인 경우, 항목은 지정된 제약 조건을 준수하면서 가능한 한 넓은 너비를 갖게 됩니다. 속성이 ‘ false ’인 경우, 항목의 너비는 ‘preferred’ 너비로 고정됩니다. 기본값은 항목의 암시적(내장) 크기 정책에 따라 달라집니다.

관련 항목: fillHeight.

Layout.horizontalStretchFactor : int [attached, since Qt 6.5]

이 속성을 사용하면 가로 확장 계수를 지정할 수 있습니다. 기본적으로 선형 레이아웃에 배치된 두 개의 동일한 항목은 크기가 같지만, 첫 번째 항목의 확장 계수가 1이고 두 번째 항목의 확장 계수가 2인 경우, 첫 번째 항목은 사용 가능한 공간의 1/3을, 두 번째 항목은 2/3를 차지하도록 조정됩니다. 단, 사용 가능한 공간의 정확히 1/3과 2/3을 차지하게 될지는 각 항목의 크기 힌트에 따라 달라집니다. 이는 예를 들어 가로 레이아웃이 최소 너비로 표시될 때, 그 모든 자식 항목도 결과적으로 최소 너비를 갖게 되기 때문입니다.

마찬가지로, 가로 레이아웃이 선호 너비를 가질 때 모든 자식 항목은 선호 너비를 가지게 되며, 가로 레이아웃이 최대 너비를 가질 때 모든 자식 항목은 최대 너비를 가지게 됩니다. 이 전략은 개별 스트레치 계수가 무엇이든 상관없이 적용됩니다. 그 결과, 스트레치 계수는 preferredWidth 와 maximumWidth 범위 내에서만 자식 항목의 확장 속도를 결정합니다.

기본값은 -1 이며, 이는 스트레치 계수가 적용되지 않음을 의미합니다.

이 속성은 Qt 6.5에서 도입되었습니다.

verticalStretchFactor도 참조하십시오 .

Layout.leftMargin : real [attached, since QtQuick.Layouts 1.2]

항목 바깥쪽의 왼쪽 여백을 지정합니다. 값이 설정되지 않은 경우, ` margins`의 값이 사용됩니다.

이 속성은 QtQuick.Layouts 1.2에서 도입되었습니다.

margins도 참조하십시오 .

Layout.margins : real [attached, since QtQuick.Layouts 1.2]

항목 외부의 여백을 모두 동일한 값으로 설정합니다. 항목 자체는 자신의 여백을 계산하지 않습니다. 여백을 계산할지 여부는 상위 요소가 결정해야 합니다.

구체적으로, 여백은 ColumnLayout, RowLayout, GridLayout 및 SplitView 와 같은 레이아웃 유사 컨테이너에서만 계산되며, 이러한 경우 여백이 증가함에 따라 항목의 유효 셀 크기도 증가합니다.

따라서 여백이 설정된 항목이 다른 ` Item`의 자식인 경우, 해당 항목의 위치, 크기 및 암시적 크기는 변경되지 않습니다.

여백을 정렬과 결합하면 여백을 포함한 항목이 정렬됩니다. 예를 들어, 상단 여백이 1 이고 하단 여백이 9 인 수직 중앙 정렬된 항목의 경우, 셀 내 항목의 유효 정렬 위치는 중앙에서 4 픽셀 위가 됩니다.

기본값은 0 입니다.

이 속성은 QtQuick.Layouts 1.2에서 도입되었습니다.

leftMargin, topMargin, rightMargin 및 bottomMargin도 참조하십시오 .

Layout.maximumHeight : real [attached]

기본값은 항목의 묵시적 최대 높이입니다.

항목이 레이아웃인 경우, 암시적 최대 높이는 해당 레이아웃 내의 어떤 항목도 최대 높이를 초과하지 않는 상태에서 레이아웃이 가질 수 있는 최대 높이가 됩니다. 그 외 모든 항목의 암시적 최대 높이는 ` Number.POSITIVE_INFINITY`입니다.

이 값을 -1 로 설정하면 높이가 암시적 최대 높이로 재설정됩니다.

minimumHeight 및 preferredHeight도 참조하십시오 .

Layout.maximumWidth : real [attached]

이 속성은 레이아웃 내 항목의 최대 너비를 지정합니다. 기본값은 해당 항목의 암시적 최대 너비입니다.

항목이 레이아웃인 경우, 암시적 최대 너비는 해당 레이아웃에 포함된 어떤 항목도 최대 너비를 초과하지 않는 상태에서 레이아웃이 가질 수 있는 최대 너비가 됩니다. 그 외 모든 항목의 암시적 최대 너비는 ` Number.POSITIVE_INFINITY`입니다.

이 값을 ` -1 `로 설정하면 너비가 암시적 최대 너비로 재설정됩니다.

minimumWidth 및 preferredWidth도 참조하십시오 .

Layout.minimumHeight : real [attached]

이 속성은 레이아웃 내 항목의 최소 높이를 지정합니다. 기본값은 항목의 암시적 최소 높이입니다.

항목이 레이아웃인 경우, 암시적 최소 높이는 레이아웃 내의 어떤 항목도 최소 높이 이하로 축소되지 않으면서 레이아웃이 가질 수 있는 최소 높이입니다. 그 외 모든 항목의 암시적 최소 높이는 ` 0`입니다.

이 값을 -1로 설정하면 높이가 암시적 최소 높이로 재설정됩니다.

preferredHeight 및 maximumHeight도 참조하십시오 .

Layout.minimumWidth : real [attached]

이 속성은 레이아웃 내 항목의 최소 너비를 지정합니다. 기본값은 항목의 암시적 최소 너비입니다.

항목이 레이아웃인 경우, 암시적 최소 너비는 레이아웃 내의 어떤 항목도 최소 너비 이하로 축소되지 않으면서 레이아웃이 가질 수 있는 최소 너비가 됩니다. 그 외 모든 항목의 암시적 최소 너비는 ` 0`입니다.

이 값을 -1로 설정하면 너비가 암시적 최소 너비로 재설정됩니다.

preferredWidth 및 maximumWidth도 참조하십시오 .

Layout.preferredHeight : real [attached]

이 속성은 레이아웃 내 항목의 우선 높이를 지정합니다. 우선 높이가 ` -1 `인 경우 무시되며, 레이아웃은 대신 ` implicitHeight `를 사용합니다. 기본값은 ` -1`입니다.

minimumHeight 및 maximumHeight도 참조하십시오 .

Layout.preferredWidth : real [attached]

이 속성은 레이아웃 내 항목의 선호 너비를 지정합니다. 선호 너비가 ` -1 `인 경우 이 값은 무시되며, 레이아웃은 대신 ` implicitWidth `을 사용합니다. 기본값은 ` -1`입니다.

minimumWidth 및 maximumWidth도 참조하십시오 .

Layout.rightMargin : real [attached, since QtQuick.Layouts 1.2]

항목 바깥쪽의 오른쪽 여백을 지정합니다. 값이 설정되지 않은 경우, ` margins`의 값이 사용됩니다.

이 속성은 QtQuick.Layouts 1.2에서 도입되었습니다.

margins도 참조하십시오 .

Layout.row : int [attached]

이 속성을 사용하면 GridLayout 내 항목의 행 위치를 지정할 수 있습니다.

column 와 이 속성이 모두 설정되지 않은 경우, 해당 항목에 셀을 할당하는 것은 레이아웃의 결정에 달려 있습니다.

기본값은 ` 0`입니다.

column 및 rowSpan항목도 참조하십시오 .

Layout.rowSpan : int [attached]

이 속성을 사용하면 GridLayout 내 항목의 행 스팬을 지정할 수 있습니다.

기본값은 1 입니다.

columnSpan 및 row항목도 참조하십시오 .

Layout.topMargin : real [attached, since QtQuick.Layouts 1.2]

항목 바깥쪽의 상단 여백을 지정합니다. 값이 설정되지 않은 경우, ` margins`의 값이 사용됩니다.

이 속성은 QtQuick.Layouts 1.2에서 도입되었습니다.

margins도 참조하십시오 .

Layout.useDefaultSizePolicy : enumeration [attached, since 6.8]

이 속성을 사용하면 사용자가 컴포넌트 수준에서 레이아웃 크기 정책을 구성할 수 있습니다.

기본값은 애플리케이션 속성 ` Qt::AA_QtQuickUseDefaultSizePolicy`을 조회하여 상속됩니다. 이 속성을 사용하여 해당 값을 재정의할 수 있습니다.

이 속성은 Qt 6.8에서 도입되었습니다.

Layout.verticalStretchFactor : int [attached, since Qt 6.5]

이 속성을 사용하면 수직 확장 계수를 지정할 수 있습니다. 기본적으로 선형 레이아웃에 배치된 두 개의 동일한 항목은 크기가 같지만, 첫 번째 항목의 확장 계수가 1이고 두 번째 항목의 확장 계수가 2인 경우, 첫 번째 항목은 사용 가능한 공간의 1/3을, 두 번째 항목은 2/3를 차지하도록 조정됩니다. 단, 사용 가능한 공간의 정확히 1/3과 2/3을 차지하게 될지는 각 항목의 크기 힌트에 따라 달라집니다. 이는 예를 들어 수직 레이아웃이 최소 높이로 표시될 때, 그 모든 자식 항목도 결과적으로 최소 높이를 갖게 되기 때문입니다.

마찬가지로, 수직 레이아웃이 선호 높이를 갖는 경우 모든 자식 항목도 선호 높이를 가지게 되며, 수직 레이아웃이 최대 높이를 갖는 경우 모든 자식 항목은 최대 높이를 가지게 됩니다. 이 전략은 개별 신축 계수가 무엇이든 상관없이 적용됩니다. 그 결과, 신축 계수는 preferredHeight 과 maximumHeight 범위 내에서만 자식 항목의 확장 속도를 결정합니다.

기본값은 -1 이며, 이는 신축 계수가 적용되지 않음을 의미합니다.

이 속성은 Qt 6.5에서 도입되었습니다.

horizontalStretchFactor도 참조하십시오 .