Layout QML Type
Fournit des propriétés attachées pour les éléments poussés sur un GridLayout, RowLayout ou ColumnLayout. Plus...
| Import Statement: | import QtQuick.Layouts |
Propriétés attaché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 Disposition est attaché aux enfants de la disposition afin de fournir des informations spécifiques à la disposition sur l'élément. Les propriétés de l'objet joint influencent la manière dont la disposition organisera les éléments.
Par exemple, vous pouvez spécifier minimumWidth, preferredWidth, et maximumWidth si les valeurs par défaut ne sont pas satisfaisantes.
Lorsqu'une mise en page est redimensionnée, les éléments peuvent s'agrandir ou se rétrécir. C'est pourquoi les éléments ont une taille minimale de minimum size, preferred size et maximum size.
Si la taille minimale d'un élément n'a pas été explicitement spécifiée, la taille est fixée à 0. Si la taille maximale d'un élément n'a pas été explicitement spécifiée, la taille est fixée à Number.POSITIVE_INFINITY.
Pour les mises en page, les tailles minimales et maximales implicites dépendent du contenu des mises en page.
Les propriétés fillWidth et fillHeight peuvent être true ou false. Si elles sont false, la taille de l'élément sera fixée à sa taille préférée. Sinon, elle augmentera ou diminuera entre sa taille minimale et sa taille maximale lorsque la mise en page sera redimensionnée. S'il existe plusieurs éléments pour lesquels fillWidth (ou fillHeight) est défini sur true, la mise en page augmentera ou réduira les éléments en fonction du ratio de leur taille préférée.
Pour plus de détails sur l'algorithme de mise en page, voir également la page Qt Quick Layouts Overview (Vue d'ensemble des mises en page).
Remarque : ne vous liez pas aux propriétés x, y, width ou height des éléments d'une disposition, car cela entrerait en conflit avec les objectifs de la disposition 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, calculée à partir des propriétés minimum/préféré/maximum attachées, et peuvent être réécrites à 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 attachées
Layout.alignment : Qt.Alignment
Cette propriété permet de spécifier l'alignement d'un élément dans la ou les cellules qu'il occupe.
La valeur par défaut est 0, ce qui signifie qu'il sera 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 drapeaux suivants :
- Qt::AlignLeft
- Qt::AlignHCenter
- Qt::AlignRight
- Qt::AlignTop
- Qt::AlignVCenter
- Qt::AlignBottom
- Qt::AlignBaseline
Layout.bottomMargin : real [since QtQuick.Layouts 1.2]
Spécifie la marge inférieure à l'extérieur d'un élément. Si la valeur n'est pas définie, elle utilisera la valeur de margins.
Cette propriété a été introduite dans QtQuick.Layouts 1.2.
Voir également margins.
Layout.column : int
Cette propriété vous permet de spécifier la position en colonne d'un élément dans une page GridLayout.
Si row et cette propriété ne sont pas définies, c'est à la mise en page d'attribuer une cellule à l'élément.
La valeur par défaut est 0.
Voir également row et columnSpan.
Layout.columnSpan : int
Cette propriété vous permet de spécifier l'espacement des colonnes d'un élément dans un site GridLayout.
La valeur par défaut est 1.
Voir également rowSpan et column.
Layout.fillHeight : bool
Si cette propriété est true, l'élément sera aussi haut que possible tout en respectant les contraintes données. Si la propriété est false, l'élément aura une hauteur fixe fixée à 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 true pour les mises en page.
Voir également fillWidth.
Layout.fillWidth : bool
Si cette propriété est true, l'élément sera aussi large que possible tout en respectant les contraintes données. Si la propriété est false, l'élément aura une largeur fixe fixée à 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 true pour les mises en page.
Voir également fillHeight.
Layout.horizontalStretchFactor : int [since Qt 6.5]
Cette propriété vous permet de spécifier le facteur d'étirement horizontal. Par défaut, deux éléments identiques disposés de manière 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 élément tentera d'obtenir 1/3 de l'espace disponible, et le second tentera d'obtenir 2/3 de l'espace disponible. Il est à noter que le fait qu'ils occupent exactement 1/3 et 2/3 de l'espace disponible dépend de leurs indices de taille. En effet, lorsque, par exemple, une disposition horizontale est affichée dans sa largeur minimale, tous ses éléments enfants auront également leur largeur minimale.
De même, lorsqu'une disposition horizontale a sa largeur préférentielle, tous les éléments enfants auront leur largeur préférentielle, et lorsqu'une disposition horizontale a sa largeur maximale, tous les éléments enfants auront leur largeur maximale. Cette stratégie est appliquée 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 qu'entre preferredWidth et maximumWidth.
La valeur par défaut est -1, ce qui signifie qu'aucun facteur d'étirement n'est appliqué.
Remarque : il faut pour cela que Layout::fillWidth ait la valeur "true" (vrai).
Cette propriété a été introduite dans Qt 6.5.
Voir aussi verticalStretchFactor.
Layout.leftMargin : real [since QtQuick.Layouts 1.2]
Spécifie la marge gauche à l'extérieur d'un élément. Si la valeur n'est pas définie, elle utilisera la valeur de margins.
Cette propriété a été introduite dans QtQuick.Layouts 1.2.
Voir également margins.
Layout.margins : real [since QtQuick.Layouts 1.2]
Définit les marges à l'extérieur d'un élément pour qu'elles aient toutes la même valeur. L'élément lui-même n'évalue pas ses propres marges. Il incombe au parent de décider s'il souhaite évaluer les marges.
Plus précisément, les marges ne sont évaluées que par ColumnLayout, RowLayout, GridLayout, et d'autres conteneurs de type mise en page, tels que SplitView, où la taille effective des cellules d'un élément sera augmentée au fur et à mesure que les marges seront augmentées.
Par conséquent, si un élément avec 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 permet d'aligner l'élément , y compris 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 de 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 aussi leftMargin, topMargin, rightMargin, et bottomMargin.
Layout.maximumHeight : real
La valeur par défaut est la hauteur maximale implicite de l'élément.
Si l'élément est une disposition, la hauteur maximale implicite sera la hauteur maximale que la disposition peut avoir 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.
La définition de cette valeur à -1 réinitialisera la hauteur à sa hauteur maximale implicite.
Voir également minimumHeight et preferredHeight.
Layout.maximumWidth : real
Cette propriété définit la largeur maximale d'un élément dans une mise en page. La valeur par défaut est la largeur maximale implicite de l'élément.
Si l'élément est une mise en page, la largeur maximale implicite sera 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 de tout autre élément est Number.POSITIVE_INFINITY.
La définition de cette valeur à -1 réinitialisera la largeur à sa largeur maximale implicite.
Voir également minimumWidth et preferredWidth.
Layout.minimumHeight : real
Cette propriété définit la hauteur minimale d'un élément dans une mise en page. La valeur par défaut est la hauteur minimale implicite de l'élément.
Si l'élément est une mise en page, la hauteur minimale implicite sera 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.
La définition de cette valeur à -1 réinitialise la hauteur à sa hauteur minimale implicite.
Voir également preferredHeight et maximumHeight.
Layout.minimumWidth : real
Cette propriété définit la largeur minimale d'un élément dans une mise en page. La valeur par défaut est la largeur minimale implicite de l'élément.
Si l'élément est une mise en page, la largeur minimale implicite sera 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 de tout autre élément est 0.
En fixant cette valeur à -1, la largeur sera ramenée à sa largeur minimale implicite.
Voir également preferredWidth et maximumWidth.
Layout.preferredHeight : real
Cette propriété indique 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 implicitHeight à la place. La valeur par défaut est -1.
Voir également minimumHeight et maximumHeight.
Layout.preferredWidth : real
Cette propriété indique 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 [since QtQuick.Layouts 1.2]
Spécifie la marge droite à l'extérieur d'un élément. Si la valeur n'est pas définie, elle utilisera la valeur de margins.
Cette propriété a été introduite dans QtQuick.Layouts 1.2.
Voir également margins.
Layout.row : int
Cette propriété vous permet de spécifier la position sur la ligne d'un élément dans une page GridLayout.
Si column et cette propriété ne sont pas définies, c'est à la mise en page d'attribuer une cellule à l'élément.
La valeur par défaut est 0.
Voir également column et rowSpan.
Layout.rowSpan : int
Cette propriété vous permet de spécifier l'interligne d'un élément dans une page GridLayout.
La valeur par défaut est 1.
Voir également columnSpan et row.
Layout.topMargin : real [since QtQuick.Layouts 1.2]
Spécifie la marge supérieure à l'extérieur d'un élément. Si la valeur n'est pas définie, elle utilisera la valeur de margins.
Cette propriété a été introduite dans QtQuick.Layouts 1.2.
Voir également margins.
Layout.useDefaultSizePolicy : enumeration [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 sera héritée en interrogeant 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 disposition n'utilise pas de politique de taille implicite. |
Cette propriété a été introduite dans Qt 6.8.
Layout.verticalStretchFactor : int [since Qt 6.5]
Cette propriété vous permet de spécifier le facteur d'étirement vertical. Par défaut, deux éléments identiques disposés de manière 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 élément tentera d'obtenir 1/3 de l'espace disponible, et le second tentera d'obtenir 2/3 de l'espace disponible. Il est à noter que le fait qu'ils occupent exactement 1/3 et 2/3 de l'espace disponible dépend de leurs indices de taille. En effet, lorsque, par exemple, une disposition verticale est affichée à sa hauteur minimale, tous ses éléments enfants auront également leur hauteur minimale.
De même, lorsqu'une disposition verticale a sa hauteur préférentielle, tous les éléments enfants auront leur hauteur préférentielle, et lorsqu'une disposition verticale a sa hauteur maximale, tous les éléments enfants auront leur hauteur maximale. Cette stratégie est appliquée 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 qu'entre preferredHeight et maximumHeight.
La valeur par défaut est -1, ce qui signifie qu'aucun facteur d'étirement n'est appliqué.
Remarque : il faut pour cela que Layout::fillHeight ait la valeur "true" (vrai).
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.
