이 페이지에서

ColumnLayout QML Type

GridLayout 와 동일하지만 열이 하나뿐입니다. 더 보기...

Import Statement: import QtQuick.Layouts
Inherits:

Item

속성

상세 설명

이 타입을 보다 효율적으로 사용하려면 Qt Quick Layouts 모듈의 일반적인 작동 원리를 이해하는 것이 좋습니다. 자세한 내용은 Qt Quick Layouts Overview를 참조하십시오.

이 타입은 더 간결한 API를 제공하므로 개발자의 편의를 위해 제공됩니다.

ColumnLayout의 항목은 다음과 같은 첨부 속성을 지원합니다:

수직으로 쌓인 세 개의 직사각형: 빨간색, 초록색, 파란색

ColumnLayout{
    spacing: 2

    Rectangle {
        Layout.alignment: Qt.AlignCenter
        color: "red"
        Layout.preferredWidth: 40
        Layout.preferredHeight: 40
    }

    Rectangle {
        Layout.alignment: Qt.AlignRight
        color: "green"
        Layout.preferredWidth: 40
        Layout.preferredHeight: 70
    }

    Rectangle {
        Layout.alignment: Qt.AlignBottom
        Layout.fillHeight: true
        color: "blue"
        Layout.preferredWidth: 70
        Layout.preferredHeight: 40
    }
}

부속 속성에 대한 자세한 내용은 여기에서 확인하십시오.

RowLayout, GridLayout, StackLayout, Column 및 Qt Quick Layouts 개요도참조하십시오 .

속성 문서

layoutDirection : enumeration [since QtQuick.Layouts 1.1]

이 속성은 열 레이아웃의 배열 방향을 지정하며, 열 내 항목의 수평 정렬을 제어합니다. ‘ Qt.RightToLeft ’가 지정되면, 왼쪽 정렬된 항목은 오른쪽 정렬로, 오른쪽 정렬된 항목은 왼쪽 정렬로 변경됩니다.

사용 가능한 값:

상수설명
Qt.LeftToRight(기본값) 항목은 왼쪽에서 오른쪽으로 배치됩니다.
Qt.RightToLeft항목이 오른쪽에서 왼쪽으로 배열됩니다.

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

GridLayout::layoutDirection 및 RowLayout::layoutDirection도 참조하십시오 .

spacing : real

이 속성은 각 셀 간의 간격을 지정합니다. 기본값은 5 입니다.

uniformCellSizes : bool [since QtQuick.Layouts 6.6]

이 속성이 ` true`로 설정되면, 레이아웃은 모든 셀의 크기를 균일하게 조정합니다.

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

GridLayout::uniformCellWidths, GridLayout::uniformCellHeights 및 RowLayout::uniformCellSizes도 참조하십시오 .

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.