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
- count : int
- currentIndex : int
- stackingMode : StackingMode
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.
| Constante | Valor | Descripción |
|---|---|---|
QStackedLayout::StackOne | 0 | Solo el widget actual es visible. Este es el valor predeterminado. |
QStackedLayout::StackAll | 1 | Todos 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.