Sur cette page

ColumnLayout QML Type

Identique à GridLayout, mais avec une seule colonne. Plus...

Import Statement: import QtQuick.Layouts
Inherits:

Item

Propriétés

Description détaillée

Pour pouvoir utiliser ce type plus efficacement, il est recommandé de comprendre le mécanisme général du module Qt Quick Layouts. Pour plus d'informations, reportez-vous à Qt Quick Layouts Overview.

Ce type est disponible par commodité pour les développeurs, car il offre une API plus propre.

Les éléments d'un ColumnLayout prennent en charge ces propriétés attachées :

Trois rectangles empilés verticalement : rouge, vert, bleu

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

Pour en savoir plus sur les propriétés attachées , cliquez ici.

Voir également RowLayout, GridLayout, StackLayout, Column, et Qt Quick Layouts Overview.

Documentation sur les propriétés

layoutDirection : enumeration [since QtQuick.Layouts 1.1]

Cette propriété définit la direction de la mise en page de la colonne - elle contrôle l'alignement horizontal des éléments au sein de la colonne. Si Qt.RightToLeft est spécifié, les éléments alignés à gauche seront alignés à droite et les éléments alignés à droite seront alignés à gauche.

Valeurs possibles :

ConstanteDescription
Qt.LeftToRight(par défaut) Les éléments sont disposés de gauche à droite.
Qt.RightToLeftLes éléments sont disposés de droite à gauche

Cette propriété a été introduite dans QtQuick.Layouts 1.1.

Voir également GridLayout::layoutDirection et RowLayout::layoutDirection.

spacing : real

Cette propriété définit l'espacement entre chaque cellule. La valeur par défaut est 5.

uniformCellSizes : bool [since QtQuick.Layouts 6.6]

Si cette propriété est définie sur true, la disposition forcera toutes les cellules à avoir une taille uniforme.

Cette propriété a été introduite dans QtQuick.Layouts 6.6.

Voir également GridLayout::uniformCellWidths, GridLayout::uniformCellHeights, et 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.