En esta página

QStackedLayout Class

La clase QStackedLayout proporciona una pila de widgets en la que solo se ve un widget a la vez. Más información...

Encabezado: #include <QStackedLayout>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
Heredado de: QLayout

Tipos públicos

enum StackingMode { StackOne, StackAll }

Propiedades

Funciones públicas

QStackedLayout()
QStackedLayout(QLayout *parentLayout)
QStackedLayout(QWidget *parent)
virtual ~QStackedLayout()
int addWidget(QWidget *widget)
int currentIndex() const
QWidget *currentWidget() const
int insertWidget(int index, QWidget *widget)
void setStackingMode(QStackedLayout::StackingMode stackingMode)
QStackedLayout::StackingMode stackingMode() const
QWidget *widget(int index) const

Funciones públicas reimplementadas

virtual void addItem(QLayoutItem *item) override
virtual int count() const override
virtual bool hasHeightForWidth() const override
virtual int heightForWidth(int width) const override
virtual QLayoutItem *itemAt(int index) const override
virtual QSize minimumSize() const override
virtual void setGeometry(const QRect &rect) override
virtual QSize sizeHint() const override
virtual QLayoutItem *takeAt(int index) override

Ranuras públicas

void setCurrentIndex(int index)
void setCurrentWidget(QWidget *widget)

Señales

void currentChanged(int index)
(since 6.9) void widgetAdded(int index)
void widgetRemoved(int index)

Descripción detallada

QStackedLayout se puede utilizar para crear una interfaz de usuario similar a la que ofrece QTabWidget. También existe una clase de uso práctico, QStackedWidget, basada en QStackedLayout.

Un QStackedLayout puede contenerse varios widgets secundarios («páginas»). Por ejemplo:

QWidget *firstPageWidget = new QWidget;
QWidget *secondPageWidget = new QWidget;
QWidget *thirdPageWidget = new QWidget;

QStackedLayout *stackedLayout = new QStackedLayout;
stackedLayout->addWidget(firstPageWidget);
stackedLayout->addWidget(secondPageWidget);
stackedLayout->addWidget(thirdPageWidget);

QVBoxLayout *mainLayout = new QVBoxLayout;
mainLayout->addLayout(stackedLayout);
setLayout(mainLayout);

QStackedLayout no proporciona ningún medio intrínseco para que el usuario cambie de página. Esto se suele hacer mediante un ` QComboBox ` o un ` QListWidget ` que almacena los títulos de las páginas de QStackedLayout. Por ejemplo:

QComboBox *pageComboBox = new QComboBox;
pageComboBox->addItem(tr("Page 1"));
pageComboBox->addItem(tr("Page 2"));
pageComboBox->addItem(tr("Page 3"));
connect(pageComboBox, &QComboBox::activated,
        stackedLayout, &QStackedLayout::setCurrentIndex);

Al rellenar un diseño, los widgets se añaden a una lista interna. La función indexOf() devuelve el índice de un widget en dicha lista. Los widgets pueden añadirse al final de la lista mediante la función addWidget() o insertarse en un índice determinado mediante la función insertWidget(). La función removeWidget() elimina del diseño el widget situado en el índice indicado. El número de widgets que contiene el diseño puede obtenerse mediante la función count().

La función widget() devuelve el widget situado en un índice determinado. El índice del widget que se muestra en pantalla viene dado por currentIndex() y puede modificarse mediante setCurrentIndex(). De manera similar, el widget que se muestra actualmente puede recuperarse mediante la función currentWidget() y modificarse mediante la función setCurrentWidget().

Cada vez que cambia el widget actual del diseño o se elimina un widget del diseño, se emiten las señales currentChanged() y widgetRemoved(), respectivamente.

Véase también QStackedWidget y QTabWidget.

Documentación sobre los tipos de miembros

enum QStackedLayout::StackingMode

Esta enumeración especifica cómo gestiona el diseño la visibilidad de sus widgets secundarios.

ConstanteValorDescripción
QStackedLayout::StackOne0Solo el widget actual es visible. Este es el valor predeterminado.
QStackedLayout::StackAll1Todos los widgets están visibles. El widget actual simplemente se destaca.

Documentación de la propiedad

[read-only] count : int

Esta propiedad contiene el número de widgets que hay en el diseño

Funciones de acceso:

virtual int count() const override

Véase también currentIndex() y widget().

currentIndex : int

Esta propiedad contiene la posición en el índice del widget que está visible

El índice actual es -1 si no hay ningún widget activo.

Funciones de acceso:

int currentIndex() const
void setCurrentIndex(int index)

Señal de notificador:

void currentChanged(int index)

Véase también currentWidget() y indexOf().

stackingMode : StackingMode

Determina cómo se gestiona la visibilidad de los widgets secundarios.

El valor por defecto es « StackOne ». Al establecer la propiedad en « StackAll », se permite utilizar el diseño para widgets superpuestos que realizan dibujos adicionales sobre otros widgets, por ejemplo, editores gráficos.

Funciones de acceso:

QStackedLayout::StackingMode stackingMode() const
void setStackingMode(QStackedLayout::StackingMode stackingMode)

Documentación de funciones de miembro

QStackedLayout::QStackedLayout()

Crea un QStackedLayout sin elemento padre.

Este QStackedLayout debe instalarse posteriormente en un widget para que surta efecto.

Véase también addWidget() y insertWidget().

[explicit] QStackedLayout::QStackedLayout(QLayout *parentLayout)

Crea un nuevo objeto `QStackedLayout` y lo inserta en el objeto ` parentLayout` indicado.

[explicit] QStackedLayout::QStackedLayout(QWidget *parent)

Crea un nuevo QStackedLayout con el parent indicado.

Este diseño se instalará en el widget ` parent ` y gestionará la geometría de sus elementos hijos.

[virtual noexcept] QStackedLayout::~QStackedLayout()

Destruye este QStackedLayout. Ten en cuenta que los widgets del diseño no se destruyen.

[override virtual] void QStackedLayout::addItem(QLayoutItem *item)

Reimplementa: QLayout::addItem(QLayoutItem *item).

int QStackedLayout::addWidget(QWidget *widget)

Añade el « widget » indicado al final de este diseño y devuelve la posición en el índice del « widget ».

Si el ` QStackedLayout ` está vacío antes de llamar a esta función, el ` widget ` especificado se convierte en el widget actual.

Véanse también insertWidget(), removeWidget() y setCurrentWidget().

[signal] void QStackedLayout::currentChanged(int index)

Esta señal se emite cada vez que cambia el widget actual del diseño. La propiedad ` index ` especifica el índice del nuevo widget actual, o -1 si no hay ninguno nuevo (por ejemplo, si no hay widgets en ` QStackedLayout`).

Nota: Señalde notificador para la propiedad currentIndex.

Véase también currentWidget() y setCurrentWidget().

QWidget *QStackedLayout::currentWidget() const

Devuelve el widget actual o ` nullptr ` si no hay ningún widget en este diseño.

Véase también currentIndex() y setCurrentWidget().

[override virtual] bool QStackedLayout::hasHeightForWidth() const

Reimplementa: QLayoutItem::hasHeightForWidth() const.

[override virtual] int QStackedLayout::heightForWidth(int width) const

Reimplementa: QLayoutItem::heightForWidth(int) const.

int QStackedLayout::insertWidget(int index, QWidget *widget)

Inserta el « widget » indicado en el « index » indicado en este « QStackedLayout ». Si « index » está fuera de rango, el widget se añade al final (en cuyo caso se devuelve el índice real del « widget »).

Si el QStackedLayout está vacío antes de llamar a esta función, el widget especificado se convierte en el widget actual.

Al insertar un nuevo widget en un índice menor o igual que el índice actual, este se incrementará, pero se mantendrá el widget actual.

Véanse también addWidget(), removeWidget() y setCurrentWidget().

[override virtual] QLayoutItem *QStackedLayout::itemAt(int index) const

Reimplementa: ` QLayout::itemAt(int index) const`.

[override virtual] QSize QStackedLayout::minimumSize() const

Reimplementa: ` QLayout::minimumSize()` const.

[slot] void QStackedLayout::setCurrentWidget(QWidget *widget)

Establece el widget actual como el especificado en widget. El nuevo widget actual debe estar ya incluido en este diseño apilado.

Véase también setCurrentIndex() y currentWidget().

[override virtual] void QStackedLayout::setGeometry(const QRect &rect)

Reimplementa: QLayout::setGeometry(const QRect &r).

[override virtual] QSize QStackedLayout::sizeHint() const

Reimplementa: ` QLayoutItem::sizeHint()` const.

[override virtual] QLayoutItem *QStackedLayout::takeAt(int index)

Reimplementa: QLayout::takeAt(int index).

QWidget *QStackedLayout::widget(int index) const

Devuelve el widget situado en la posición indicada index, o nullptr si no hay ningún widget en dicha posición.

Véase también currentWidget() y indexOf().

[signal, since 6.9] void QStackedLayout::widgetAdded(int index)

Esta señal se emite cada vez que se añade o se inserta un widget. Se pasa como parámetro el objeto ` index ` del widget.

Esta función se introdujo en Qt 6.9.

Véase también addWidget() y insertWidget().

[signal] void QStackedLayout::widgetRemoved(int index)

Esta señal se emite cada vez que se elimina un widget del diseño. Se pasa como parámetro el objeto ` index ` del widget.

Véase también removeWidget().

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