StackLayout QML Type

Die Klasse „StackLayout“ stellt einen Stapel von Elementen bereit, von denen jeweils nur eines sichtbar ist. Mehr...

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

• count : int
• currentIndex : int

Zugehörige 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, sollten Sie sich mit der allgemeinen Funktionsweise des Moduls „ Qt Quick Layouts “ vertraut machen. Weitere Informationen finden Sie unter „Qt Quick Layouts – Überblick “.

Das aktuell sichtbare Element kann durch Setzen der Eigenschaft „ currentIndex “ geändert werden. Der Index entspricht der Reihenfolge der untergeordneten Elemente des „StackLayout“.

Im Gegensatz zu den meisten anderen Layouts sind die Eigenschaften „ Layout.fillWidth “ und „ Layout.fillHeight “ der untergeordneten Elemente standardmäßig auf „ true “ gesetzt. Folglich werden untergeordnete Elemente standardmäßig so ausgefüllt, dass sie der Größe des „StackLayout“ entsprechen, sofern ihre „ Layout.maximumWidth “ oder „ Layout.maximumHeight “ dies nicht verhindern.

Elemente werden dem Layout hinzugefügt, indem die Zuordnung des Elements zum Layout geändert wird. Entsprechend erfolgt das Entfernen durch das Entfernen der Zuordnung des Elements zum Layout. Beide Vorgänge wirken sich auf die Eigenschaft „ count “ des Layouts aus.

Der folgende Code erstellt ein StackLayout, in dem nur das Rechteck „plum“ 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 die folgenden angehängten Eigenschaften:

• Layout.minimumWidth
• Layout.minimumHeight
• Layout.preferredWidth
• Layout.preferredHeight
• Layout.maximumWidth
• Layout.maximumHeight
• Layout.fillWidth
• Layout.fillHeight

Weitere Informationen zu angehängten Eigenschaften finden Sie hier.

Siehe auch „ ColumnLayout“ , „ GridLayout “, „ RowLayout “, „ StackView “ und „Qt Quick Layouts – Übersicht“.

Dokumentation zu Eigenschaften

count : int [read-only]

Diese Eigenschaft enthält die Anzahl der Elemente, die zum Layout gehören.

Nur Elemente, die untergeordnete Elemente des „ StackLayout “ sind, kommen für die Layoutzuordnung in Frage.

currentIndex : int

Diese Eigenschaft enthält den Index des untergeordneten Elements, das derzeit im „ StackLayout “ sichtbar ist. Standardmäßig lautet er bei einem leeren Layout „ -1 “, andernfalls ist der Standardwert „ 0 “ (bezieht sich auf das erste Element).

Seit Version 6.5 führt das Einfügen bzw. Entfernen eines neuen Elements an einem Index, der kleiner oder gleich dem aktuellen Index ist, zu einer Erhöhung bzw. Verringerung des aktuellen Index, wobei das aktuelle Element jedoch beibehalten wird.

Dokumentation zu angehängten Eigenschaften

StackLayout.index : int [read-only attached, since QtQuick.Layouts 1.15]

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 [read-only attached, since QtQuick.Layouts 1.15]

Diese angehängte Eigenschaft ist „ true “, wenn dieses untergeordnete Element das aktuelle Element in der „ StackLayout “ ist.

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

Siehe auch „ index “ und „ layout “.

StackLayout.layout : StackLayout [read-only attached, since QtQuick.Layouts 1.15]

Diese angehängte Eigenschaft enthält das „ StackLayout “, das dieses untergeordnete Element verwaltet.

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

Siehe auch „ index “ und „ isCurrentItem “.