StackLayout QML Type

La classe StackLayout permet de créer une pile d'éléments dont un seul est visible à la fois. En savoir plus...

• Liste de tous les membres, y compris les membres hérités

Propriétés

• count : int
• currentIndex : int

Propriétés associées

• index : int (since QtQuick.Layouts 1.15)
• isCurrentItem : bool (since QtQuick.Layouts 1.15)
• layout : StackLayout (since QtQuick.Layouts 1.15)

Description détaillée

Pour utiliser ce type de manière plus efficace, il est recommandé de bien comprendre le fonctionnement général du module Qt Quick Layouts. Pour plus d'informations, consultez la présentation de Qt Quick Layouts .

L'élément actuellement visible peut être modifié en définissant la propriété ` currentIndex `. L'index correspond à l'ordre des enfants du `StackLayout`.

Contrairement à la plupart des autres mises en page, les propriétés ` Layout.fillWidth ` et ` Layout.fillHeight ` des éléments enfants sont définies par défaut sur ` true`. Par conséquent, les éléments enfants sont, par défaut, ajustés pour correspondre à la taille du `StackLayout`, à condition que leurs propriétés ` Layout.maximumWidth ` ou ` Layout.maximumHeight ` ne l’empêchent pas.

Les éléments sont ajoutés à la mise en page en les rattachant à celle-ci. De même, leur suppression s'effectue en les détachant de la mise en page. Ces deux opérations ont une incidence sur la propriété ` count ` de la mise en page.

Le code suivant créera un StackLayout dans lequel seul le rectangle « plum » sera visible.

StackLayout {
    id: layout
    anchors.fill: parent
    currentIndex: 1
    Rectangle {
        color: 'teal'
        implicitWidth: 200
        implicitHeight: 200
    }
    Rectangle {
        color: 'plum'
        implicitWidth: 300
        implicitHeight: 200
    }
}

Les éléments d’un StackLayout prennent en charge les propriétés associées suivantes :

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

Pour en savoir plus sur les propriétés associées, cliquez ici.

Voir également ColumnLayout, GridLayout, RowLayout, StackView et Présentation deQt Quick Layouts .

Documentation sur les propriétés

count : int [read-only]

Cette propriété contient le nombre d'éléments appartenant à la mise en page.

Seuls les éléments qui sont des enfants de l'StackLayout e seront pris en compte pour la mise en page.

currentIndex : int

Cette propriété contient l'index de l'élément enfant actuellement visible dans l'StackLayout. Par défaut, elle vaut « -1 » pour une mise en page vide ; sinon, la valeur par défaut est « 0 » (correspondant au premier élément).

Depuis la version 6.5, l'insertion ou la suppression d'un nouvel élément à un index inférieur ou égal à l'index actuel entraîne l'incrémentation ou la décrémentation de l'index actuel, tout en conservant l'élément actuel.

Documentation sur les propriétés associées

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

Cette propriété associée contient l'index de chaque élément enfant de l'StackLayout.

Cette propriété a été introduite dans QtQuick.Layouts 1.15.

Voir également « isCurrentItem » et « layout ».

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

Cette propriété associée prend la valeur « true » si cet enfant est l'élément actif dans l'StackLayout.

Cette propriété a été introduite dans QtQuick.Layouts 1.15.

Voir également index et layout.

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

Cette propriété associée contient l'StackLayout e qui gère cet élément enfant.

Cette propriété a été introduite dans QtQuick.Layouts 1.15.

Voir également « index » et « isCurrentItem ».