Layout QML Type

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

기본값은 0, 즉 Qt.AlignVCenter | Qt.AlignLeft 입니다. 가로 또는 세로 플래그만 지정된 경우에도 이러한 기본값이 적용됩니다. 가로 플래그만 지정된 경우 기본 세로 플래그는 Qt.AlignVCenter 이며, 세로 플래그만 지정된 경우 기본 가로 플래그는 Qt.AlignLeft 입니다.

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

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

항목 외부의 하단 여백을 지정합니다. 값을 설정하지 않으면 margins 의 값을 사용합니다.

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

margins 를참조하십시오 .

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

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

기본값은 0 입니다.

row 및 columnSpan 을참조하세요 .

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

기본값은 1 입니다.

rowSpan 및 column도 참조하십시오 .

이 속성이 true 인 경우 항목은 주어진 제약 조건을 준수하면서 가능한 한 높이가 됩니다. 속성이 false 인 경우 항목의 높이가 기본 높이로 설정된 고정 높이가 됩니다. 기본값은 항목의 암시적(기본 제공) 크기 정책에 따라 달라집니다.

fillWidth 를참조하세요 .

이 속성이 true 인 경우 항목은 주어진 제약 조건을 준수하면서 가능한 한 넓어집니다. 속성이 false 인 경우 항목은 기본 너비로 설정된 고정 너비를 갖습니다. 기본값은 항목의 암시적(기본 제공) 크기 정책에 따라 달라집니다.

fillHeight 를참조하세요 .

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

마찬가지로 가로 레이아웃에 기본 너비가 설정되어 있으면 모든 하위 항목의 기본 너비가 설정되고, 가로 레이아웃에 최대 너비가 설정되어 있으면 모든 하위 항목의 최대 너비가 설정됩니다. 이 전략은 개별 스트레치 요소에 관계없이 적용됩니다. 따라서 스트레치 인자는 preferredWidth ~ maximumWidth 범위 사이에서만 하위 항목의 성장률을 결정합니다.

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

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

verticalStretchFactor 를참조하십시오 .

항목 외부의 왼쪽 여백을 지정합니다. 값을 설정하지 않으면 margins 의 값을 사용합니다.

이 프로퍼티는 QtQuick.Layouts 1.2에 도입되었습니다.

margins 를참조하십시오 .

항목 외부의 여백이 모두 같은 값을 갖도록 설정합니다. 항목 자체는 자체 여백을 평가하지 않습니다. 여백을 평가할지 여부는 부모가 결정할 책임이 있습니다.

특히 여백은 ColumnLayout, RowLayout, GridLayout, 그리고 여백이 증가함에 따라 항목의 유효 셀 크기가 증가하는 SplitView 와 같은 기타 레이아웃과 유사한 컨테이너에서만 평가됩니다.

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

여백과 정렬을 결합하면 여백을 포함하여 항목이 정렬됩니다. 예를 들어 위쪽 여백이 1, 아래쪽 여백이 9 인 세로로 가운데 있는 항목은 셀 내에서 항목의 유효 정렬이 가운데에서 4픽셀 위쪽이 됩니다.

기본값은 0 입니다.

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

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

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

항목이 레이아웃인 경우, 암시적 최대 높이는 레이아웃의 항목이 최대 높이를 초과하지 않고 가질 수 있는 최대 높이가 됩니다. 다른 항목의 암시적 최대 높이는 Number.POSITIVE_INFINITY 입니다.

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

minimumHeight 및 preferredHeight 을참조하세요 .

이 속성은 레이아웃에서 항목의 최대 너비를 보유합니다. 기본값은 항목의 암시적 최대 너비입니다.

항목이 레이아웃인 경우 암시적 최대 너비는 레이아웃의 항목이 최대 너비를 초과하지 않고 레이아웃이 가질 수 있는 최대 너비입니다. 다른 항목의 암시적 최대 너비는 Number.POSITIVE_INFINITY 입니다.

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

minimumWidth 및 preferredWidth 을참조하세요 .

이 속성은 레이아웃에서 항목의 최소 높이를 보유합니다. 기본값은 항목의 암시적 최소 높이입니다.

항목이 레이아웃인 경우 암시적 최소 높이는 레이아웃의 항목이 최소 높이 아래로 줄어들지 않고 레이아웃이 가질 수 있는 최소 높이가 됩니다. 다른 항목의 암시적 최소 높이는 0 입니다.

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

preferredHeight 및 maximumHeight 을참조하세요 .

이 속성은 레이아웃에서 항목의 최소 너비를 보유합니다. 기본값은 항목의 암시적 최소 너비입니다.

항목이 레이아웃인 경우 암시적 최소 너비는 레이아웃의 항목이 최소 너비 아래로 줄어들지 않고 레이아웃이 가질 수 있는 최소 너비입니다. 다른 항목의 암시적 최소 너비는 0 입니다.

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

preferredWidth 및 maximumWidth 을참조하세요 .

이 속성은 레이아웃에서 항목의 기본 높이를 보유합니다. 기본 높이가 -1 인 경우 무시되고 레이아웃은 대신 implicitHeight 을 사용합니다. 기본값은 -1 입니다.

minimumHeight 및 maximumHeight 을참조하세요 .

이 속성은 레이아웃에서 항목의 기본 너비를 보유합니다. 기본 너비가 -1 인 경우 무시되고 레이아웃은 implicitWidth 을 대신 사용합니다. 기본값은 -1 입니다.

minimumWidth 및 maximumWidth 을참조하세요 .

항목 외부의 오른쪽 여백을 지정합니다. 값을 설정하지 않으면 margins 의 값을 사용합니다.

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

margins 를참조하십시오 .

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

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

기본값은 0 입니다.

column 및 rowSpan 을참조하세요 .

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

기본값은 1 입니다.

columnSpan 및 row도 참조 하세요.

항목 외부의 상단 여백을 지정합니다. 값을 설정하지 않으면 margins 의 값을 사용합니다.

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

margins 를참조하십시오 .

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

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

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

이 속성을 사용하면 세로 늘이기 계수를 지정할 수 있습니다. 기본적으로 선형 레이아웃에 배열된 두 개의 동일한 항목은 동일한 크기를 갖지만 첫 번째 항목의 스트레치 계수가 1이고 두 번째 항목의 스트레치 계수가 2인 경우 첫 번째 항목은 사용 가능한 공간의 1/3을, 두 번째 항목은 사용 가능한 공간의 2/3을 목표로 합니다. 사용 가능한 공간의 정확히 1/3과 2/3이 되는지 여부는 크기 힌트에 따라 달라집니다. 예를 들어 세로 레이아웃이 최소 높이로 표시되면 모든 하위 항목도 결과적으로 최소 높이가 되기 때문입니다.

마찬가지로 세로 레이아웃의 높이가 기본 높이인 경우 모든 하위 항목의 높이가 기본 높이가 되고, 세로 레이아웃의 높이가 최대 높이인 경우 모든 하위 항목의 높이가 최대 높이가 됩니다. 이 전략은 개별 스트레치 요소에 관계없이 적용됩니다. 따라서 스트레치 인자는 preferredHeight ~ maximumHeight 범위 사이에서만 하위 항목의 성장률을 결정합니다.

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

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

horizontalStretchFactor 를참조하십시오 .