Layout QML Type
Stellt angehängte Eigenschaften für Elemente bereit, die an ein „ GridLayout “, „ RowLayout “ oder „ ColumnLayout “ übergeben werden. Mehr...
| Import Statement: | import QtQuick.Layouts |
Angeschlossene Eigenschaften
- 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)
Ausführliche Beschreibung
Ein Objekt vom Typ „Layout“ wird an die untergeordneten Elemente des Layouts angehängt, um layoutspezifische Informationen über das Element bereitzustellen. Die Eigenschaften des angehängten Objekts beeinflussen, wie das Layout die Elemente anordnet.
Beispielsweise können Sie „ minimumWidth “, „ preferredWidth “ und „ maximumWidth “ angeben, wenn die Standardwerte nicht zufriedenstellend sind.
Wenn die Größe eines Layouts geändert wird, können Elemente größer oder kleiner werden. Aus diesem Grund verfügen Elemente über eine ` minimum size`, eine ` preferred size ` und eine ` maximum size`.
Wenn für ein Element keine Mindestgröße explizit festgelegt wurde, wird die Größe auf „ 0 “ gesetzt. Wenn für ein Element keine Höchstgröße explizit festgelegt wurde, wird die Größe auf „ Number.POSITIVE_INFINITY “ gesetzt.
Bei Layouts hängen die impliziten Mindest- und Höchstgrößen vom Inhalt der Layouts ab.
Die Eigenschaften „ fillWidth “ und „ fillHeight “ können entweder auf „ true “ oder „ false “ gesetzt werden. Sind sie auf „ false “ gesetzt, wird die Größe des Elements auf seine bevorzugte Größe festgelegt. Andernfalls vergrößert oder verkleinert es sich bei einer Größenänderung des Layouts zwischen seiner minimalen und maximalen Größe. Wenn mehrere Elemente mit „ fillWidth “ (oder „ fillHeight “) auf „ true “ gesetzt sind, vergrößert oder verkleinert das Layout die Elemente proportional zu ihrem bevorzugten Größenverhältnis.
Weitere Informationen zum Layout-Algorithmus finden Sie auch in der Übersicht „Qt Quick Layouts “.
Hinweis: BindenSie sich nicht an die Eigenschaften „x“, „y“, „width“ oder „height“ von Elementen in einem Layout, da dies im Widerspruch zu den Zielen von „Layout“ steht und zudem zu Bindungsschleifen führen kann. Die Eigenschaften „width“ und „height“ werden von der Layout-Engine verwendet, um die aktuelle Größe der Elemente zu speichern, die anhand der angehängten Eigenschaften „minimum“, „preferred“ und „maximum“ berechnet wird, und können bei jedem Layout-Vorgang überschrieben werden. Verwenden Sie „ Layout.preferredWidth “ und „ Layout.preferredHeight “ oder „ implicitWidth “ und „ implicitHeight “, um die bevorzugte Größe der Elemente festzulegen.
Siehe auch GridLayout, RowLayout und ColumnLayout.
Dokumentation zu angehängten Eigenschaften
Layout.alignment : Qt.Alignment [attached]
Mit dieser Eigenschaft können Sie die Ausrichtung eines Elements innerhalb der Zelle(n) festlegen, die es einnimmt.
Der Standardwert ist „ 0 “, was bedeutet, dass die Ausrichtung „ Qt.AlignVCenter | Qt.AlignLeft “ lautet. Diese Standardwerte gelten auch, wenn nur ein horizontales oder vertikales Flag angegeben wird: Wenn nur ein horizontales Flag angegeben wird, lautet das Standard-Vertikal-Flag „ Qt.AlignVCenter “, und wenn nur ein vertikales Flag angegeben wird, lautet das Standard-Horizontal-Flag „ Qt.AlignLeft “.
Eine gültige Ausrichtung ist eine Kombination aus den folgenden Flags:
- Qt::AlignLeft
- Qt::AlignHCenter
- Qt::AlignRight
- Qt::AlignTop
- Qt::AlignVCenter
- Qt::AlignBottom
- Qt::AlignBaseline
Layout.bottomMargin : real [attached, since QtQuick.Layouts 1.2]
Legt den unteren Rand außerhalb eines Elements fest. Wenn kein Wert festgelegt ist, wird der Wert aus „ margins “ verwendet.
Diese Eigenschaft wurde in QtQuick.Layouts 1.2 eingeführt.
Siehe auch margins.
Layout.column : int [attached]
Mit dieser Eigenschaft können Sie die Spaltenposition eines Elements in einem „ GridLayout “ festlegen.
Wenn weder „ row “ noch diese Eigenschaft festgelegt sind, obliegt es dem Layout, dem Element eine Zelle zuzuweisen.
Der Standardwert ist „ 0 “.
Siehe auch „ row “ und „ columnSpan “.
Layout.columnSpan : int [attached]
Mit dieser Eigenschaft können Sie die Spaltenbreite eines Elements in einem „ GridLayout “ festlegen.
Der Standardwert ist „ 1 “.
Siehe auch „ rowSpan “ und „ column “.
Layout.fillHeight : bool [attached]
Wenn diese Eigenschaft auf „ true “ gesetzt ist, wird das Element unter Berücksichtigung der vorgegebenen Einschränkungen so hoch wie möglich dargestellt. Ist die Eigenschaft auf „ false “ gesetzt, hat das Element eine feste Höhe, die auf die bevorzugte Höhe festgelegt ist. Der Standardwert hängt von der impliziten (integrierten) Größenrichtlinie des Elements ab.
Hinweis: Standardmäßig ist diese Eigenschaft für Layouts auf „ true “ gesetzt.
Siehe auch „ fillWidth “.
Layout.fillWidth : bool [attached]
Wenn diese Eigenschaft auf „ true “ gesetzt ist, wird das Element unter Einhaltung der vorgegebenen Einschränkungen so breit wie möglich dargestellt. Ist die Eigenschaft auf „ false “ gesetzt, hat das Element eine feste Breite, die auf die bevorzugte Breite festgelegt ist. Der Standardwert hängt von der impliziten (integrierten) Größenrichtlinie des Elements ab.
Hinweis: Standardmäßig ist diese Eigenschaft bei Layouts auf „ true “ gesetzt.
Siehe auch „ fillHeight “.
Layout.horizontalStretchFactor : int [attached, since Qt 6.5]
Mit dieser Eigenschaft können Sie den horizontalen Dehnungsfaktor festlegen. Standardmäßig haben zwei identische Elemente, die in einem linearen Layout angeordnet sind, dieselbe Größe. Wenn jedoch das erste Element einen Streckungsfaktor von 1 und das zweite Element einen Streckungsfaktor von 2 hat, wird das erste Element versuchen, 1/3 des verfügbaren Platzes einzunehmen, und das zweite Element wird versuchen, 2/3 des verfügbaren Platzes einzunehmen. Beachten Sie, dass es von den Größenangaben der Elemente abhängt, ob sie tatsächlich genau 1/3 bzw. 2/3 des verfügbaren Platzes einnehmen. Dies liegt daran, dass beispielsweise bei einem horizontalen Layout, das in seiner minimalen Breite angezeigt wird, alle untergeordneten Elemente folglich ebenfalls ihre minimale Breite annehmen.
Ebenso haben alle untergeordneten Elemente ihre bevorzugte Breite, wenn ein horizontales Layout seine bevorzugte Breite hat, und alle untergeordneten Elemente haben ihre maximale Breite, wenn ein horizontales Layout seine maximale Breite hat. Diese Strategie wird unabhängig von den einzelnen Stretch-Faktoren angewendet. Infolgedessen bestimmen die Stretch-Faktoren die Wachstumsrate der untergeordneten Elemente nur im Bereich zwischen preferredWidth und maximumWidth.
Der Standardwert ist ` -1`, was bedeutet, dass kein Stretch-Faktor angewendet wird.
Hinweis: Dies setzt voraus, dass „ Layout::fillWidth “ auf „true“ gesetzt ist
Diese Eigenschaft wurde in Qt 6.5 eingeführt.
Siehe auch „ verticalStretchFactor “.
Layout.leftMargin : real [attached, since QtQuick.Layouts 1.2]
Legt den linken Rand außerhalb eines Elements fest. Wenn der Wert nicht festgelegt ist, wird der Wert aus „ margins “ verwendet.
Diese Eigenschaft wurde in QtQuick.Layouts 1.2 eingeführt.
Siehe auch margins.
Layout.margins : real [attached, since QtQuick.Layouts 1.2]
Legt fest, dass alle Ränder außerhalb eines Elements denselben Wert haben. Das Element selbst berechnet seine eigenen Ränder nicht. Es obliegt dem übergeordneten Element, zu entscheiden, ob es die Ränder berechnen möchte.
Insbesondere werden Ränder nur von ` ColumnLayout`, ` RowLayout`, ` GridLayout` und anderen layoutähnlichen Containern wie ` SplitView` ausgewertet, wobei die effektive Zellengröße eines Elements mit zunehmenden Rändern vergrößert wird.
Wenn also ein Element mit Rändern ein untergeordnetes Element eines anderen ` Item` ist, bleiben seine Position, Größe und implizite Größe unverändert.
Kombiniert man Ränder mit einer Ausrichtung, wird das Element einschließlich seiner Ränder ausgerichtet. Beispielsweise führt ein vertikal zentriertes Element mit einem oberen Rand von 1 und einem unteren Rand von 9 dazu, dass die effektive Ausrichtung des Elements innerhalb der Zelle 4 Pixel oberhalb der Mitte liegt.
Der Standardwert lautet 0.
Diese Eigenschaft wurde in QtQuick.Layouts 1.2 eingeführt.
Siehe auch „ leftMargin“ , „ topMargin “, „ rightMargin “ und „ bottomMargin “.
Layout.maximumHeight : real [attached]
Der Standardwert ist die implizite maximale Höhe des Elements.
Handelt es sich bei dem Element um ein Layout, entspricht die implizite maximale Höhe der maximalen Höhe, die das Layout erreichen kann, ohne dass eines seiner Elemente über seine maximale Höhe hinauswächst. Die implizite maximale Höhe für alle anderen Elemente beträgt Number.POSITIVE_INFINITY.
Wird dieser Wert auf „ -1 “ gesetzt, wird die Höhe auf die implizite maximale Höhe zurückgesetzt.
Siehe auch „ minimumHeight “ und „ preferredHeight “.
Layout.maximumWidth : real [attached]
Diese Eigenschaft gibt die maximale Breite eines Elements in einem Layout an. Der Standardwert ist die implizite maximale Breite des Elements.
Handelt es sich bei dem Element um ein Layout, entspricht die implizite maximale Breite der maximalen Breite, die das Layout haben kann, ohne dass eines seiner Elemente über seine maximale Breite hinauswächst. Die implizite maximale Breite für alle anderen Elemente beträgt „ Number.POSITIVE_INFINITY “.
Wird dieser Wert auf „ -1 “ gesetzt, wird die Breite auf ihre implizite maximale Breite zurückgesetzt.
Siehe auch „ minimumWidth “ und „ preferredWidth “.
Layout.minimumHeight : real [attached]
Diese Eigenschaft gibt die Mindesthöhe eines Elements in einem Layout an. Der Standardwert ist die implizite Mindesthöhe des Elements.
Handelt es sich bei dem Element um ein Layout, entspricht die implizite Mindesthöhe der Mindesthöhe, die das Layout haben kann, ohne dass eines seiner Elemente unter seine Mindesthöhe geschrumpft wird. Die implizite Mindesthöhe für alle anderen Elemente beträgt „ 0 “.
Wird dieser Wert auf -1 gesetzt, wird die Höhe auf ihre implizite Mindesthöhe zurückgesetzt.
Siehe auch „ preferredHeight “ und „ maximumHeight “.
Layout.minimumWidth : real [attached]
Diese Eigenschaft gibt die Mindestbreite eines Elements in einem Layout an. Der Standardwert ist die implizite Mindestbreite des Elements.
Handelt es sich bei dem Element um ein Layout, entspricht die implizite Mindestbreite der Mindestbreite, die das Layout haben kann, ohne dass eines seiner Elemente unter seine Mindestbreite schrumpft. Die implizite Mindestbreite für alle anderen Elemente beträgt „ 0 “.
Wird dieser Wert auf -1 gesetzt, wird die Breite auf die implizite Mindestbreite zurückgesetzt.
Siehe auch „ preferredWidth “ und „ maximumWidth “.
Layout.preferredHeight : real [attached]
Diese Eigenschaft enthält die bevorzugte Höhe eines Elements in einem Layout. Wenn die bevorzugte Höhe auf „ -1 “ gesetzt ist, wird sie ignoriert, und das Layout verwendet stattdessen „ implicitHeight “. Der Standardwert ist „ -1 “.
Siehe auch „ minimumHeight “ und „ maximumHeight “.
Layout.preferredWidth : real [attached]
Diese Eigenschaft enthält die bevorzugte Breite eines Elements in einem Layout. Wenn die bevorzugte Breite „ -1 “ lautet, wird sie ignoriert, und das Layout verwendet stattdessen „ implicitWidth “. Der Standardwert ist „ -1 “.
Siehe auch „ minimumWidth “ und „ maximumWidth “.
Layout.rightMargin : real [attached, since QtQuick.Layouts 1.2]
Legt den rechten Rand außerhalb eines Elements fest. Wenn der Wert nicht festgelegt ist, wird der Wert aus „ margins “ verwendet.
Diese Eigenschaft wurde in QtQuick.Layouts 1.2 eingeführt.
Siehe auch margins.
Layout.row : int [attached]
Mit dieser Eigenschaft können Sie die Zeilenposition eines Elements in einem „ GridLayout “ festlegen.
Wenn weder „ column “ noch diese Eigenschaft festgelegt sind, obliegt es dem Layout, dem Element eine Zelle zuzuweisen.
Der Standardwert ist „ 0 “.
Siehe auch „ column “ und „ rowSpan “.
Layout.rowSpan : int [attached]
Mit dieser Eigenschaft können Sie die Zeilenausdehnung eines Elements in einem „ GridLayout “ festlegen.
Der Standardwert ist „ 1 “.
Siehe auch „ columnSpan “ und „ row “.
Layout.topMargin : real [attached, since QtQuick.Layouts 1.2]
Legt den oberen Rand außerhalb eines Elements fest. Wenn der Wert nicht festgelegt ist, wird der Wert aus „ margins “ verwendet.
Diese Eigenschaft wurde in QtQuick.Layouts 1.2 eingeführt.
Siehe auch margins.
Layout.useDefaultSizePolicy : enumeration [attached, since 6.8]
Mit dieser Eigenschaft kann der Benutzer die Richtlinie zur Layoutgröße auf Komponentenebene konfigurieren.
Der Standardwert wird durch Abfrage des Anwendungsattributs „ Qt::AA_QtQuickUseDefaultSizePolicy “ übernommen. Mit dieser Eigenschaft können Sie diesen Wert überschreiben.
| Konstante | Beschreibung |
|---|---|
Layout.SizePolicyImplicit | Das Element im Layout verwendet implizite oder integrierte Größenrichtlinien |
Layout.SizePolicyExplicit | Das Element im Layout verwendet keine impliziten Größenrichtlinien. |
Diese Eigenschaft wurde in Qt 6.8 eingeführt.
Layout.verticalStretchFactor : int [attached, since Qt 6.5]
Mit dieser Eigenschaft können Sie den vertikalen Dehnungsfaktor festlegen. Standardmäßig haben zwei identische Elemente, die in einem linearen Layout angeordnet sind, dieselbe Größe. Wenn jedoch das erste Element einen Streckungsfaktor von 1 und das zweite Element einen Streckungsfaktor von 2 hat, wird das erste Element versuchen, 1/3 des verfügbaren Platzes einzunehmen, und das zweite Element wird versuchen, 2/3 des verfügbaren Platzes einzunehmen. Beachten Sie, dass es von den Größenangaben der Elemente abhängt, ob sie tatsächlich genau 1/3 bzw. 2/3 des verfügbaren Platzes einnehmen. Dies liegt daran, dass beispielsweise bei einem vertikalen Layout, das mit seiner minimalen Höhe angezeigt wird, alle untergeordneten Elemente folglich ebenfalls ihre minimale Höhe annehmen.
Ebenso haben alle untergeordneten Elemente ihre bevorzugte Höhe, wenn ein vertikales Layout seine bevorzugte Höhe hat, und alle untergeordneten Elemente haben ihre maximale Höhe, wenn ein vertikales Layout seine maximale Höhe hat. Diese Strategie wird unabhängig von den einzelnen Streckfaktoren angewendet. Infolgedessen bestimmen Streckfaktoren nur die Wachstumsrate der untergeordneten Elemente im Bereich zwischen preferredHeight und maximumHeight.
Der Standardwert ist „ -1 “, was bedeutet, dass kein Stretch-Faktor angewendet wird.
Hinweis: Dies setzt voraus, dass „ Layout::fillHeight “ auf „true“ gesetzt ist
Diese Eigenschaft wurde in Qt 6.5 eingeführt.
Siehe auch „ 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.
