Sur cette page

ColumnLayout QML Type

Identique à GridLayout, mais ne comportant qu'une seule colonne. En savoir plus...

Import Statement: import QtQuick.Layouts
Inherits:

Item

Propriétés

Description détaillée

Pour utiliser ce type de manière plus efficace, il est recommandé de bien comprendre le fonctionnement général du module Qt Quick Layouts. Reportez-vous à la section Présentation deQt Quick Layouts pour plus d’informations.

Il est proposé à titre de commodité pour les développeurs, car il offre une API plus épurée.

Les éléments d'un ColumnLayout prennent en charge les propriétés associées suivantes :

Trois rectangles superposé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 associées, cliquez ici.

Voir également RowLayout, GridLayout, StackLayout, Column et la présentation deQt Quick Layouts .

Documentation sur les propriétés

layoutDirection : enumeration [since QtQuick.Layouts 1.1]

Cette propriété définit le sens de mise en page de la disposition en colonnes ; elle contrôle l'alignement horizontal des éléments au sein de la colonne. Si la valeur « Qt.RightToLeft » est spécifiée, les éléments alignés à gauche seront alignés à droite et ceux 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 mise en page imposera une taille uniforme à toutes les cellules.

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.