StackLayout QML Type
Die Klasse StackLayout bietet einen Stapel von Elementen, von denen jeweils nur ein Element sichtbar ist. Mehr...
Import Statement: | import QtQuick.Layouts |
Inherits: |
Eigenschaften
- count : int
- currentIndex : int
Beigefügte Eigenschaften
- index : int
(since QtQuick.Layouts 1.15)
- isCurrentItem : bool
(since QtQuick.Layouts 1.15)
- layout : StackLayout
(since QtQuick.Layouts 1.15)
Ausführliche Beschreibung
Um diesen Typ effizienter nutzen zu können, empfiehlt es sich, den allgemeinen Mechanismus des Moduls Qt Quick Layouts zu verstehen. Weitere Informationen finden Sie unter Qt Quick Layouts Overview.
Das aktuell sichtbare Element kann durch Setzen der Eigenschaft currentIndex geändert werden. Der Index entspricht der Reihenfolge der Kinder des StackLayouts.
Im Gegensatz zu den meisten anderen Layouts sind die Eigenschaften Layout.fillWidth und Layout.fillHeight der untergeordneten Elemente standardmäßig auf true
eingestellt. Folglich werden untergeordnete Elemente standardmäßig so gefüllt, dass sie der Größe des StackLayouts entsprechen, sofern ihre Layout.maximumWidth oder Layout.maximumHeight dies nicht verhindern.
Das Hinzufügen von Elementen zum Layout erfolgt durch Reparenting des Elements zum Layout. Das Entfernen von Objekten erfolgt durch Reparenting des Objekts aus dem Layout. Beide Vorgänge haben Auswirkungen auf die Eigenschaft count des Layouts.
Mit dem folgenden Code wird ein StackLayout erstellt, in dem nur das Rechteck "Pflaume" sichtbar ist.
StackLayout { id: layout anchors.fill: parent currentIndex: 1 Rectangle { color: 'teal' implicitWidth: 200 implicitHeight: 200 } Rectangle { color: 'plum' implicitWidth: 300 implicitHeight: 200 } }
Elemente in einem StackLayout unterstützen diese angehängten Eigenschaften:
- Layout.minimumWidth
- Layout.minimumHeight
- Layout.preferredWidth
- Layout.preferredHeight
- Layout.maximumWidth
- Layout.maximumHeight
- Layout.fillWidth
- Layout.fillHeight
Lesen Sie hier mehr über angehängte Eigenschaften.
Siehe auch ColumnLayout, GridLayout, RowLayout, StackView, und Qt Quick Layouts Übersicht.
Eigenschaft Dokumentation
count : int |
Diese Eigenschaft enthält die Anzahl der Elemente, die zum Layout gehören.
Nur Elemente, die untergeordnete Elemente von StackLayout sind, kommen für die Layouterstellung in Frage.
currentIndex : int |
Diese Eigenschaft enthält den Index des untergeordneten Elements, das derzeit in StackLayout sichtbar ist. Standardmäßig ist dies -1
für ein leeres Layout, andernfalls ist der Standardwert 0
(mit Bezug auf das erste Element).
Seit Version 6.5 wird beim Einfügen/Entfernen eines neuen Elements mit einem Index, der kleiner oder gleich dem aktuellen Index ist, der aktuelle Index erhöht/verringert, aber das aktuelle Element bleibt erhalten.
Dokumentation der angehängten Eigenschaft
StackLayout.index : int |
Diese angehängte Eigenschaft enthält den Index jedes untergeordneten Elements in der StackLayout.
Diese Eigenschaft wurde in QtQuick.Layouts 1.15 eingeführt.
Siehe auch isCurrentItem und layout.
StackLayout.isCurrentItem : bool |
Diese angehängte Eigenschaft ist true
, wenn dieses untergeordnete Element das aktuelle Element in StackLayout ist.
Diese Eigenschaft wurde in QtQuick.Layouts 1.15 eingeführt.
StackLayout.layout : StackLayout |
Diese angehängte Eigenschaft enthält die StackLayout, die dieses untergeordnete Element verwaltet.
Diese Eigenschaft wurde in QtQuick.Layouts 1.15 eingeführt.
Siehe auch index und isCurrentItem.
© 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.