Layout QML Type

Bietet angehängte Eigenschaften für Elemente, die auf GridLayout, RowLayout oder ColumnLayout verschoben werden. Mehr...

Import Statement: import QtQuick.Layouts

Angehängte Eigenschaften

Detaillierte Beschreibung

Ein Objekt vom Typ Layout wird an untergeordnete Objekte des Layouts angehängt, um layoutspezifische Informationen über das Element bereitzustellen. Die Eigenschaften des angehängten Objekts beeinflussen, wie das Layout die Elemente anordnet.

Sie können zum Beispiel minimumWidth, preferredWidth und maximumWidth angeben, wenn die Standardwerte nicht zufriedenstellend sind.

Wenn die Größe eines Layouts geändert wird, können die Objekte wachsen oder schrumpfen. Aus diesem Grund haben die Elemente eine minimum size, preferred size und eine maximum size.

Wurde die Mindestgröße für einen Artikel nicht explizit angegeben, wird die Größe auf 0 gesetzt. Wurde die maximale Größe für einen Artikel nicht explizit angegeben, 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 true oder false sein. Wenn sie false sind, wird die Größe des Elements auf seine bevorzugte Größe festgelegt. Andernfalls wächst oder schrumpft es zwischen seiner minimalen und maximalen Größe, wenn die Größe des Layouts geändert wird. Wenn es mehrere Objekte gibt, deren fillWidth (oder fillHeight) auf true gesetzt ist, vergrößert oder verkleinert das Layout die Objekte im Verhältnis ihrer bevorzugten Größe.

Weitere Einzelheiten zum Layout-Algorithmus finden Sie auch in der ÜbersichtQt Quick Layouts.

Hinweis: Binden Sie nicht an die x-, y-, Breiten- oder Höheneigenschaften von Elementen in einem Layout, da dies den Zielen von Layout zuwiderlaufen würde und außerdem Bindungsschleifen verursachen kann. Die Eigenschaften width und height werden von der Layout-Engine verwendet, um die aktuelle Größe der Elemente zu speichern, die aus den angehängten Eigenschaften minimum/preferred/maximum berechnet wird, und können jedes Mal überschrieben werden, wenn die Elemente angelegt werden. Verwenden Sie Layout.preferredWidth und Layout.preferredHeight, oder implicitWidth und implicitHeight, um die bevorzugte Größe von Objekten anzugeben.

Siehe auch GridLayout, RowLayout, und ColumnLayout.

Dokumentation der Eigenschaft Attached

Layout.alignment : Qt.Alignment

Mit dieser Eigenschaft können Sie die Ausrichtung eines Elements innerhalb der Zelle(n), die es belegt, festlegen.

Der Standardwert ist 0, was bedeutet, dass es Qt.AlignVCenter | Qt.AlignLeft sein wird. Diese Standardwerte gelten auch, wenn nur eine horizontale oder vertikale Markierung angegeben wird: Wenn nur eine horizontale Markierung angegeben wird, ist die vertikale Standardmarkierung Qt.AlignVCenter, und wenn nur eine vertikale Markierung angegeben wird, ist die horizontale Standardmarkierung Qt.AlignLeft.

Eine gültige Ausrichtung ist eine Kombination aus den folgenden Flaggen:


Layout.bottomMargin : real [since QtQuick.Layouts 1.2]

Gibt den unteren Rand außerhalb eines Elements an. Wenn der Wert nicht gesetzt ist, wird der Wert von margins verwendet.

Diese Eigenschaft wurde in QtQuick.Layouts 1.2 eingeführt.

Siehe auch margins.


Layout.column : int

Mit dieser Eigenschaft können Sie die Spaltenposition eines Elements in einem GridLayout angeben.

Wenn sowohl row als auch diese Eigenschaft nicht gesetzt sind, ist es Sache des Layouts, dem Element eine Zelle zuzuweisen.

Der Standardwert ist 0.

Siehe auch row und columnSpan.


Layout.columnSpan : int

Mit dieser Eigenschaft können Sie den Spaltenbereich eines Elements in einem GridLayout angeben.

Der Standardwert ist 1.

Siehe auch rowSpan und column.


Layout.fillHeight : bool

Wenn diese Eigenschaft true lautet, ist das Element so hoch wie möglich, wobei die gegebenen Beschränkungen eingehalten werden. Wenn die Eigenschaft false lautet, hat das Element eine feste Höhe, die auf die bevorzugte Höhe eingestellt ist. Die Vorgabe hängt von der impliziten (eingebauten) Größenpolitik des Elements ab.

Siehe auch fillWidth.


Layout.fillWidth : bool

Wenn diese Eigenschaft true lautet, ist das Element so breit wie möglich, wobei die angegebenen Einschränkungen eingehalten werden. Wenn die Eigenschaft false lautet, hat das Element eine feste Breite, die auf die bevorzugte Breite eingestellt ist. Der Standardwert hängt von der impliziten (eingebauten) Größenpolitik des Elements ab.

Siehe auch fillHeight.


Layout.horizontalStretchFactor : int [since Qt 6.5]

Mit dieser Eigenschaft können Sie den horizontalen Streckungsfaktor festlegen. Standardmäßig haben zwei identische Elemente, die in einem linearen Layout angeordnet sind, die gleiche Größe, aber wenn 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 zu erhalten, und das zweite wird versuchen, 2/3 des verfügbaren Platzes zu erhalten. Ob sie genau 1/3 und 2/3 des verfügbaren Platzes einnehmen, hängt von ihren Größenhinweisen ab. Wenn z. B. ein horizontales Layout in seiner Mindestbreite angezeigt wird, haben alle untergeordneten Elemente folglich auch ihre Mindestbreite.

Wenn ein horizontales Layout seine bevorzugte Breite hat, haben alle untergeordneten Elemente ihre bevorzugte Breite, und wenn ein horizontales Layout seine maximale Breite hat, haben alle untergeordneten Elemente ihre maximale Breite. Diese Strategie wird unabhängig von den einzelnen Streckfaktoren angewandt. Infolgedessen bestimmen die Streckungsfaktoren nur die Wachstumsrate der untergeordneten Elemente im Bereich zwischen preferredWidth und maximumWidth.

Der Standardwert ist -1, was bedeutet, dass kein Streckungsfaktor 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 [since QtQuick.Layouts 1.2]

Legt den linken Rand außerhalb eines Elements fest. Wenn der Wert nicht gesetzt ist, wird der Wert von margins verwendet.

Diese Eigenschaft wurde in QtQuick.Layouts 1.2 eingeführt.

Siehe auch margins.


Layout.margins : real [since QtQuick.Layouts 1.2]

Legt fest, dass die Ränder außerhalb eines Elements alle den gleichen Wert haben. Das Element selbst wertet seine eigenen Ränder nicht aus. Es liegt in der Verantwortung des übergeordneten Elements, zu entscheiden, ob es die Ränder auswerten möchte.

Insbesondere werden die Ränder nur von ColumnLayout, RowLayout, GridLayout und anderen layoutähnlichen Containern wie SplitView ausgewertet, bei denen die effektive Zellengröße eines Elements erhöht wird, wenn die Ränder erhöht werden.

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.

Die Kombination von Rändern und Ausrichtung richtet das Element einschließlich seiner Ränder aus. Ein vertikal zentriertes Element mit einem oberen Rand von 1 und einem unteren Rand von 9 bewirkt beispielsweise, dass die effektive Ausrichtung des Elements innerhalb der Zelle 4 Pixel über der Mitte liegt.

Der Standardwert ist 0.

Diese Eigenschaft wurde in QtQuick.Layouts 1.2 eingeführt.

Siehe auch leftMargin, topMargin, rightMargin, und bottomMargin.


Layout.maximumHeight : real

Der Standardwert ist die implizite maximale Höhe des Elements.

Wenn es sich bei dem Element um ein Layout handelt, ist die implizite maximale Höhe die maximale Höhe, die das Layout haben kann, ohne dass eines seiner Elemente über seine maximale Höhe hinauswächst. Die implizite Maximalhöhe für alle anderen Objekte ist Number.POSITIVE_INFINITY.

Wird dieser Wert auf -1 gesetzt, wird die Höhe auf die implizite Maximalhöhe zurückgesetzt.

Siehe auch minimumHeight und preferredHeight.


Layout.maximumWidth : real

Diese Eigenschaft enthält die maximale Breite eines Objekts in einem Layout. Der Standardwert ist die implizite maximale Breite des Objekts.

Handelt es sich bei dem Element um ein Layout, ist die implizite maximale Breite die maximale 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 ist Number.POSITIVE_INFINITY.

Wenn Sie diesen Wert auf -1 setzen, wird die Breite auf die implizite maximale Breite zurückgesetzt.

Siehe auch minimumWidth und preferredWidth.


Layout.minimumHeight : real

Diese Eigenschaft enthält die Mindesthöhe eines Elements in einem Layout. Der Standardwert ist die implizite Mindesthöhe des Elements.

Handelt es sich bei dem Element um ein Layout, ist die implizite Mindesthöhe die Mindesthöhe, die das Layout haben kann, ohne dass eines seiner Elemente unter seine Mindesthöhe schrumpft. Die implizite Mindesthöhe für alle anderen Elemente ist 0.

Wenn Sie diesen Wert auf -1 setzen, wird die Höhe auf ihre implizite Mindesthöhe zurückgesetzt.

Siehe auch preferredHeight und maximumHeight.


Layout.minimumWidth : real

Diese Eigenschaft enthält die Mindestbreite eines Elements in einem Layout. Der Standardwert ist die implizite Mindestbreite des Elements.

Wenn es sich bei dem Element um ein Layout handelt, ist die implizite Mindestbreite die Mindestbreite, die das Layout haben kann, ohne dass eines seiner Elemente unter seine Mindestbreite schrumpft. Die implizite Mindestbreite für alle anderen Elemente ist 0.

Wenn Sie diesen Wert auf -1 setzen, wird die Breite auf ihre implizite Mindestbreite zurückgesetzt.

Siehe auch preferredWidth und maximumWidth.


Layout.preferredHeight : real

Diese Eigenschaft enthält die bevorzugte Höhe eines Elements in einem Layout. Wenn die bevorzugte Höhe -1 ist, wird sie ignoriert, und das Layout verwendet stattdessen implicitHeight. Der Standardwert ist -1.

Siehe auch minimumHeight und maximumHeight.


Layout.preferredWidth : real

Diese Eigenschaft enthält die bevorzugte Breite eines Objekts in einem Layout. Wenn die bevorzugte Breite -1 ist, wird sie ignoriert, und das Layout verwendet stattdessen implicitWidth. Der Standardwert ist -1.

Siehe auch minimumWidth und maximumWidth.


Layout.rightMargin : real [since QtQuick.Layouts 1.2]

Gibt den rechten Rand außerhalb eines Objekts an. Wenn der Wert nicht gesetzt ist, wird der Wert von margins verwendet.

Diese Eigenschaft wurde in QtQuick.Layouts 1.2 eingeführt.

Siehe auch margins.


Layout.row : int

Mit dieser Eigenschaft können Sie die Zeilenposition eines Elements in einem GridLayout angeben.

Wenn sowohl column als auch diese Eigenschaft nicht gesetzt sind, ist es Sache des Layouts, dem Element eine Zelle zuzuweisen.

Der Standardwert ist 0.

Siehe auch column und rowSpan.


Layout.rowSpan : int

Mit dieser Eigenschaft können Sie die Zeilenspanne eines Elements in einem GridLayout angeben.

Der Standardwert ist 1.

Siehe auch columnSpan und row.


Layout.topMargin : real [since QtQuick.Layouts 1.2]

Gibt den oberen Rand außerhalb eines Elements an. Wenn der Wert nicht gesetzt ist, wird der Wert von margins verwendet.

Diese Eigenschaft wurde in QtQuick.Layouts 1.2 eingeführt.

Siehe auch margins.


Layout.useDefaultSizePolicy : enumeration [since 6.8]

Diese Eigenschaft ermöglicht es dem Benutzer, die Layoutgrößenpolitik auf Komponentenebene zu konfigurieren.

Der Standardwert wird durch die Abfrage des Anwendungsattributs Qt::AA_QtQuickUseDefaultSizePolicy geerbt. Sie können diese Eigenschaft verwenden, um diesen Wert zu überschreiben.

KonstanteBeschreibung
Layout.SizePolicyImplicitDas Element im Layout verwendet die implizite oder eingebaute Größenrichtlinie
Layout.SizePolicyExplicitDas Element im Layout verwendet keine impliziten Größenrichtlinien.

Diese Eigenschaft wurde in Qt 6.8 eingeführt.


Layout.verticalStretchFactor : int [since Qt 6.5]

Mit dieser Eigenschaft können Sie den vertikalen Streckungsfaktor festlegen. Standardmäßig haben zwei identische Elemente, die in einem linearen Layout angeordnet sind, die gleiche Größe, aber wenn das erste Element einen Dehnungsfaktor von 1 und das zweite Element einen Dehnungsfaktor von 2 hat, wird das erste Element versuchen, 1/3 des verfügbaren Platzes einzunehmen, und das zweite wird versuchen, 2/3 des verfügbaren Platzes einzunehmen. Ob sie genau 1/3 und 2/3 des verfügbaren Platzes einnehmen, hängt von ihren Größenhinweisen ab. Denn wenn z. B. ein vertikales Layout in seiner Mindesthöhe angezeigt wird, haben alle untergeordneten Elemente folglich auch ihre Mindesthöhe.

Wenn ein vertikales Layout seine bevorzugte Höhe hat, haben alle untergeordneten Elemente ihre bevorzugte Höhe, und wenn ein vertikales Layout seine maximale Höhe hat, haben alle untergeordneten Elemente ihre maximale Höhe. Diese Strategie wird unabhängig von den einzelnen Streckfaktoren angewandt. Folglich bestimmen die Streckungsfaktoren nur die Wachstumsrate der untergeordneten Elemente im Bereich zwischen preferredHeight und maximumHeight.

Der Standardwert ist -1, was bedeutet, dass kein Streckungsfaktor 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.


© 2025 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.