Qt 5.9 | Qt Quick | QML Types | ColumnLayout QML Type

Qt 5.9.9 Reference Documentation

# ColumnLayout QML Type

Identical to GridLayout, but having only one column. More...

Import Statement: | import QtQuick.Layouts 1.3
Inherits: | Item

- List of all members, including inherited members

## Properties

- layoutDirection : enumeration
- spacing : real

## Detailed Description

It is available as a convenience for developers, as it offers a cleaner API.

Items in a ColumnLayout support these attached properties:

- Layout.minimumWidth
- Layout.minimumHeight
- Layout.preferredWidth
- Layout.preferredHeight
- Layout.maximumWidth
- Layout.maximumHeight
- Layout.fillWidth
- Layout.fillHeight
- Layout.alignment
- Layout.margins
- Layout.leftMargin
- Layout.rightMargin
- Layout.topMargin
- Layout.bottomMargin

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

Read more about attached properties here.

See also RowLayout, GridLayout, and Column.

## Property Documentation

layoutDirection : enumeration

This property holds the layout direction of the column layout - it controls whether items are laid out from left ro right or right to left. If `Qt.RightToLeft` is specified, left-aligned items will be right-aligned and right-aligned items will be left-aligned.

Possible values:

- Qt.LeftToRight (default) - Items are laid out from left to right.
- Qt.RightToLeft - Items are laid out from right to left

This QML property was introduced in QtQuick.Layouts 1.1.

See also GridLayout::layoutDirection and RowLayout::layoutDirection.

spacing : real

This property holds the spacing between each cell. The default value is `5`.