Layout QML Type
Fournit des propriétés associées aux éléments ajoutés à un « GridLayout », « RowLayout » ou « ColumnLayout ». En savoir plus…
| Import Statement: | import QtQuick.Layouts |
Propriétés associées
- alignment : Qt.Alignment
- bottomMargin : real
(since QtQuick.Layouts 1.2) - column : int
- columnSpan : int
- fillHeight : bool
- fillWidth : bool
- horizontalStretchFactor : int
(since Qt 6.5) - leftMargin : real
(since QtQuick.Layouts 1.2) - margins : real
(since QtQuick.Layouts 1.2) - maximumHeight : real
- maximumWidth : real
- minimumHeight : real
- minimumWidth : real
- preferredHeight : real
- preferredWidth : real
- rightMargin : real
(since QtQuick.Layouts 1.2) - row : int
- rowSpan : int
- topMargin : real
(since QtQuick.Layouts 1.2) - useDefaultSizePolicy : enumeration
(since 6.8) - verticalStretchFactor : int
(since Qt 6.5)
Description détaillée
Un objet de type Layout est associé aux éléments enfants de la mise en page afin de fournir des informations spécifiques à la mise en page concernant l'élément. Les propriétés de l'objet associé influencent la manière dont la mise en page organisera les éléments.
Par exemple, vous pouvez spécifier minimumWidth, preferredWidth et maximumWidth si les valeurs par défaut ne vous conviennent pas.
Lorsqu’une mise en page est redimensionnée, les éléments peuvent s’agrandir ou se réduire. De ce fait, les éléments possèdent une « taille minimale » ( minimum size), une « taille maximale » ( preferred size ) et une « taille de remplissage » ( maximum size).
Si la taille minimale n’a pas été explicitement spécifiée pour un élément, celle-ci est définie sur 0. Si la taille maximale n’a pas été explicitement spécifiée pour un élément, celle-ci est définie sur Number.POSITIVE_INFINITY.
Pour les mises en page, les tailles minimale et maximale implicites dépendent du contenu de celles-ci.
Les propriétés fillWidth et fillHeight peuvent prendre la valeur true ou false. Si elles sont définies sur false, la taille de l’élément sera fixée à sa taille préférée. Sinon, elle augmentera ou diminuera entre ses tailles minimale et maximale à mesure que la mise en page est redimensionnée. S’il existe plusieurs éléments dont la propriété fillWidth (ou fillHeight) est définie sur true, la mise en page agrandira ou réduira les éléments proportionnellement au rapport de leur taille préférée.
Pour plus de détails sur l’algorithme de mise en page, consultez également la présentation d’Qt Quick Layouts .
Remarque : ne liez pas les propriétés x, y, width ou height des éléments dans une mise en page, car cela irait à l’encontre des objectifs de Layout et pourrait également provoquer des boucles de liaison. Les propriétés width et height sont utilisées par le moteur de mise en page pour stocker la taille actuelle des éléments, telle qu’elle est calculée à partir des propriétés associées minimum, preferred et maximum, et peuvent être écrasées à chaque fois que les éléments sont mis en page. Utilisez Layout.preferredWidth et Layout.preferredHeight, ou implicitWidth et implicitHeight pour spécifier la taille préférée des éléments.
Voir également GridLayout, RowLayout et ColumnLayout.
Documentation sur les propriétés associées
Layout.alignment : Qt.Alignment [attached]
Cette propriété vous permet de définir l'alignement d'un élément au sein de la ou des cellules qu'il occupe.
La valeur par défaut est « 0 », ce qui signifie que l'élément sera aligné « Qt.AlignVCenter | Qt.AlignLeft ». Ces valeurs par défaut s'appliquent également si seul un indicateur horizontal ou vertical est spécifié : si seul un indicateur horizontal est spécifié, l'indicateur vertical par défaut sera « Qt.AlignVCenter », et si seul un indicateur vertical est spécifié, l'indicateur horizontal par défaut sera « Qt.AlignLeft ».
Un alignement valide est une combinaison des indicateurs suivants :
- Qt::AlignLeft
- Qt::AlignHCenter
- Qt::AlignRight
- Qt::AlignTop
- Qt::AlignVCenter
- Qt::AlignBottom
- Qt::AlignBaseline
Layout.bottomMargin : real [attached, since QtQuick.Layouts 1.2]
Définit la marge inférieure à l'extérieur d'un élément. Si aucune valeur n'est spécifiée, la valeur de la propriété « margins » sera utilisée.
Cette propriété a été introduite dans QtQuick.Layouts 1.2.
Voir également margins.
Layout.column : int [attached]
Cette propriété vous permet de définir la position d'un élément dans une colonne d'une grille de données ( GridLayout).
Si ni la propriété « row » ni cette propriété ne sont définies, c’est à la mise en page qu’il revient d’attribuer une cellule à l’élément.
La valeur par défaut est « 0 ».
Voir également « row » et « columnSpan ».
Layout.columnSpan : int [attached]
Cette propriété vous permet de définir l'étendue en colonnes d'un élément dans une GridLayout.
La valeur par défaut est « 1 ».
Voir également « rowSpan » et « column ».
Layout.fillHeight : bool [attached]
Si cette propriété est définie sur « true », l'élément aura la hauteur maximale possible tout en respectant les contraintes spécifiées. Si la propriété est définie sur « false », l'élément aura une hauteur fixe correspondant à la hauteur préférée. La valeur par défaut dépend de la politique de taille implicite (intégrée) de l'élément.
Remarque : par défaut, cette propriété est définie sur « true » pour les mises en page.
Voir également fillWidth.
Layout.fillWidth : bool [attached]
Si cette propriété est définie sur « true », l'élément aura la largeur maximale possible tout en respectant les contraintes spécifiées. Si la propriété est définie sur « false », l'élément aura une largeur fixe correspondant à la largeur préférée. La valeur par défaut dépend de la politique de taille implicite (intégrée) de l'élément.
Remarque : par défaut, cette propriété est définie sur « true » pour les mises en page.
Voir également fillHeight.
Layout.horizontalStretchFactor : int [attached, since Qt 6.5]
Cette propriété vous permet de définir le facteur d'étirement horizontal. Par défaut, deux éléments identiques disposés selon une mise en page linéaire auront la même taille, mais si le premier élément a un facteur d'étirement de 1 et le second un facteur d'étirement de 2, le premier cherchera à occuper 1/3 de l'espace disponible, et le second cherchera à occuper 2/3 de l'espace disponible. Notez que le fait qu’ils occupent exactement 1/3 et 2/3 de l’espace disponible dépend de leurs indications de taille. En effet, lorsqu’une disposition horizontale s’affiche par exemple à sa largeur minimale, tous ses éléments enfants auront par conséquent également leur largeur minimale.
De même, lorsqu’une mise en page horizontale a sa largeur préférée, tous les éléments enfants auront leur largeur préférée, et lorsqu’une mise en page horizontale a sa largeur maximale, tous les éléments enfants auront leur largeur maximale. Cette stratégie s’applique quels que soient les facteurs d’étirement individuels. En conséquence, les facteurs d’étirement ne déterminent le taux de croissance des éléments enfants que dans la plage comprise entre preferredWidth et maximumWidth.
La valeur par défaut est -1, ce qui signifie qu’aucun facteur d’étirement n’est appliqué.
Remarque : cela nécessite que Layout::fillWidth soit défini sur true
Cette propriété a été introduite dans Qt 6.5.
Voir également « verticalStretchFactor ».
Layout.leftMargin : real [attached, since QtQuick.Layouts 1.2]
Définit la marge gauche à l'extérieur d'un élément. Si aucune valeur n'est spécifiée, la valeur de ` margins` sera utilisée.
Cette propriété a été introduite dans QtQuick.Layouts 1.2.
Voir également margins.
Layout.margins : real [attached, since QtQuick.Layouts 1.2]
Définit les marges extérieures d'un élément de manière à ce qu'elles aient toutes la même valeur. L'élément lui-même n'évalue pas ses propres marges. Il appartient à l'élément parent de décider s'il souhaite évaluer ces marges.
Plus précisément, les marges ne sont évaluées que par ColumnLayout, RowLayout, GridLayout et d’autres conteneurs de mise en page, tels que SplitView, où la taille effective de la cellule d’un élément sera augmentée à mesure que les marges sont augmentées.
Par conséquent, si un élément doté de marges est un enfant d’un autre Item, sa position, sa taille et sa taille implicite resteront inchangées.
La combinaison des marges et de l’alignement alignera l’élément en incluant ses marges. Par exemple, un élément centré verticalement avec une marge supérieure de 1 et une marge inférieure de 9 entraînera un alignement effectif de l’élément dans la cellule à 4 pixels au-dessus du centre.
La valeur par défaut est 0.
Cette propriété a été introduite dans QtQuick.Layouts 1.2.
Voir également leftMargin, topMargin, rightMargin et bottomMargin.
Layout.maximumHeight : real [attached]
La valeur par défaut correspond à la hauteur maximale implicite de l'élément.
Si l'élément est une mise en page, la hauteur maximale implicite correspondra à la hauteur maximale que la mise en page peut atteindre sans qu'aucun de ses éléments ne dépasse sa hauteur maximale. La hauteur maximale implicite pour tout autre élément est Number.POSITIVE_INFINITY.
Définir cette valeur sur -1 réinitialisera la hauteur à sa hauteur maximale implicite.
Voir également minimumHeight et preferredHeight.
Layout.maximumWidth : real [attached]
Cette propriété définit la largeur maximale d'un élément dans une mise en page. La valeur par défaut correspond à la largeur maximale implicite de l'élément.
Si l'élément est une mise en page, la largeur maximale implicite correspondra à la largeur maximale que la mise en page peut avoir sans qu'aucun de ses éléments ne dépasse sa largeur maximale. La largeur maximale implicite pour tout autre élément est Number.POSITIVE_INFINITY.
Définir cette valeur sur -1 réinitialisera la largeur à sa largeur maximale implicite.
Voir également minimumWidth et preferredWidth.
Layout.minimumHeight : real [attached]
Cette propriété définit la hauteur minimale d'un élément dans une mise en page. La valeur par défaut correspond à la hauteur minimale implicite de l'élément.
Si l’élément est une mise en page, la hauteur minimale implicite correspondra à la hauteur minimale que la mise en page peut avoir sans qu’aucun de ses éléments ne soit réduit en dessous de sa hauteur minimale. La hauteur minimale implicite pour tout autre élément est 0.
Définir cette valeur sur -1 réinitialisera la hauteur à sa hauteur minimale implicite.
Voir également preferredHeight et maximumHeight.
Layout.minimumWidth : real [attached]
Cette propriété définit la largeur minimale d'un élément dans une mise en page. La valeur par défaut correspond à la largeur minimale implicite de l'élément.
Si l'élément est une mise en page, la largeur minimale implicite correspondra à la largeur minimale que la mise en page peut avoir sans qu'aucun de ses éléments ne soit réduit en dessous de sa largeur minimale. La largeur minimale implicite pour tout autre élément est 0.
Définir cette valeur sur -1 réinitialisera la largeur à sa largeur minimale implicite.
Voir également preferredWidth et maximumWidth.
Layout.preferredHeight : real [attached]
Cette propriété définit la hauteur préférée d'un élément dans une mise en page. Si la hauteur préférée est « -1 », elle sera ignorée et la mise en page utilisera à la place « implicitHeight ». La valeur par défaut est « -1 ».
Voir également minimumHeight et maximumHeight.
Layout.preferredWidth : real [attached]
Cette propriété définit la largeur préférée d'un élément dans une mise en page. Si la largeur préférée est « -1 », elle sera ignorée et la mise en page utilisera « implicitWidth » à la place. La valeur par défaut est « -1 ».
Voir également minimumWidth et maximumWidth.
Layout.rightMargin : real [attached, since QtQuick.Layouts 1.2]
Définit la marge droite à l'extérieur d'un élément. Si aucune valeur n'est spécifiée, la valeur de ` margins` sera utilisée.
Cette propriété a été introduite dans QtQuick.Layouts 1.2.
Voir également margins.
Layout.row : int [attached]
Cette propriété vous permet de définir la position d'un élément sur une ligne dans une grille ( GridLayout).
Si ni la propriété « column » ni cette propriété ne sont définies, c'est à la mise en page qu'il revient d'attribuer une cellule à l'élément.
La valeur par défaut est « 0 ».
Voir également « column » et « rowSpan ».
Layout.rowSpan : int [attached]
Cette propriété vous permet de définir l'étendue en lignes d'un élément dans une liste de type « GridLayout ».
La valeur par défaut est « 1 ».
Voir également « columnSpan » et « row ».
Layout.topMargin : real [attached, since QtQuick.Layouts 1.2]
Définit la marge supérieure à l'extérieur d'un élément. Si aucune valeur n'est définie, la valeur de ` margins` sera utilisée.
Cette propriété a été introduite dans QtQuick.Layouts 1.2.
Voir également margins.
Layout.useDefaultSizePolicy : enumeration [attached, since 6.8]
Cette propriété permet à l'utilisateur de configurer la politique de taille de la mise en page au niveau du composant.
La valeur par défaut est héritée via l’interrogation de l’attribut d’application « Qt::AA_QtQuickUseDefaultSizePolicy ». Vous pouvez utiliser cette propriété pour remplacer cette valeur.
| Constante | Description |
|---|---|
Layout.SizePolicyImplicit | L’élément de la mise en page utilise une politique de taille implicite ou intégrée |
Layout.SizePolicyExplicit | L'élément de la mise en page n'utilise pas de règles de taille implicites. |
Cette propriété a été introduite dans Qt 6.8.
Layout.verticalStretchFactor : int [attached, since Qt 6.5]
Cette propriété vous permet de définir le facteur d'étirement vertical. Par défaut, deux éléments identiques disposés selon une disposition linéaire auront la même taille, mais si le premier élément a un facteur d'étirement de 1 et le second un facteur d'étirement de 2, le premier cherch era à occuper 1/3 de l'espace disponible, et le second 2/3. Notez que le fait qu’ils occupent exactement 1/3 et 2/3 de l’espace disponible dépend de leurs indications de taille. En effet, lorsqu’une disposition verticale s’affiche à sa hauteur minimale, tous ses éléments enfants ont par conséquent également leur hauteur minimale.
De même, lorsqu’une mise en page verticale a sa hauteur préférée, tous les éléments enfants auront leur hauteur préférée, et lorsqu’une mise en page verticale a sa hauteur maximale, tous les éléments enfants auront leur hauteur maximale. Cette stratégie s’applique quels que soient les facteurs d’étirement individuels. Par conséquent, les facteurs d’étirement ne détermineront le taux de croissance des éléments enfants que dans la plage comprise entre preferredHeight et maximumHeight.
La valeur par défaut est -1, ce qui signifie qu’aucun facteur d’étirement n’est appliqué.
Remarque : cela nécessite que la propriété « Layout::fillHeight » soit définie sur « true ».
Cette propriété a été introduite dans Qt 6.5.
Voir aussi horizontalStretchFactor.
© 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.
