En esta página

StackLayout QML Type

La clase StackLayout proporciona una pila de elementos en la que solo se ve uno a la vez. Más...

Import Statement: import QtQuick.Layouts
Inherits:

Item

Propiedades

Propiedades adjuntas

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

Descripción detallada

Para poder utilizar este tipo de forma más eficaz, se recomienda comprender el funcionamiento general del módulo « Qt Quick Layouts». Consulte la descripción general de «Qt Quick Layouts» para obtener más información.

El elemento visible actualmente se puede modificar estableciendo la propiedad ` currentIndex `. El índice se corresponde con el orden de los elementos hijos del `StackLayout`.

A diferencia de la mayoría de los demás diseños, las propiedades « Layout.fillWidth » y « Layout.fillHeight » de los elementos hijos tienen como valor predeterminado « true ». En consecuencia, los elementos hijos se rellenan de forma predeterminada para ajustarse al tamaño del StackLayout, siempre que sus propiedades « Layout.maximumWidth » o « Layout.maximumHeight » no lo impidan.

Los elementos se añaden al diseño asignándolos de nuevo al mismo. Del mismo modo, para eliminarlos basta con desasignarlos del diseño. Ambas operaciones afectarán a la propiedad count del diseño.

El siguiente código creará un StackLayout en el que solo sea visible el rectángulo «plum».

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

Los elementos de un StackLayout admiten estas propiedades asociadas:

Más información sobre las propiedades asociadas aquí.

Véase también ColumnLayout, GridLayout, RowLayout, StackView y Qt Quick : Descripción general de los diseños.

Documentación sobre propiedades

count : int [read-only]

Esta propiedad contiene el número de elementos que forman parte del diseño.

Solo los elementos que sean hijos de la propiedad « StackLayout » podrán ser incluidos en la disposición.

currentIndex : int

Esta propiedad contiene el índice del elemento secundario que está visible actualmente en el StackLayout. Por defecto, será -1 para un diseño vacío; en caso contrario, el valor por defecto es 0 (que hace referencia al primer elemento).

A partir de la versión 6.5, al insertar o eliminar un nuevo elemento en un índice menor o igual que el índice actual, este se incrementará o disminuirá, pero se mantendrá el elemento actual.

Documentación adjunta sobre propiedades

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

Esta propiedad adjunta contiene el índice de cada elemento secundario de la clase ` StackLayout`.

Esta propiedad se introdujo en QtQuick.Layouts 1.15.

Véase también « isCurrentItem » y « layout ».

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

Esta propiedad asociada es ` true ` si este elemento secundario es el elemento actual de ` StackLayout`.

Esta propiedad se introdujo en QtQuick.Layouts 1.15.

Véase también « index » y « layout ».

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

Esta propiedad adjunta contiene el objeto ` StackLayout ` que gestiona este elemento secundario.

Esta propiedad se introdujo en QtQuick.Layouts 1.15.

Véase también « index » y « isCurrentItem ».

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