「QT」容器类之 QStackedWidget 堆栈窗口类

原创已于 2024-11-22 09:32:26 修改 · 918 阅读

15 ·

CC 4.0 BY-SA版权

文章标签：

#qt #开发语言

于 2024-11-21 13:43:06 首次发布

「QT」QT5程序设计专栏收录该内容

155 篇文章

订阅专栏

在这里插入图片描述

✨博客主页
何曾参静谧的博客（✅关注、👍点赞、⭐收藏、👻转发）
📌文章专栏
「QT」QT5程序设计
📚全部专栏（专栏会有变化，以最新发布为准）
「Win」Windows程序设计	「IDE」集成开发环境	「UG/NX」BlockUI集合
「C/C++」C/C++程序设计	「DSA」数据结构与算法	「UG/NX」NX二次开发
「QT」QT5程序设计	「File」数据文件格式	「UG/NX」NX定制开发
「Py」Python程序设计	「Math」探秘数学世界	「PK」Parasolid函数说明
「Web」前后端全栈开发	「En」英语从零到一	👍占位符

QStackedWidget在Qt 5.15中的详细介绍

一、引言

QStackedWidget是Qt框架中一个非常实用的控件，它允许开发者在同一个位置堆叠多个页面（QWidget），并通过编程方式或用户交互来切换显示这些页面。每个页面都可以包含不同的控件和布局，而QStackedWidget则负责管理这些页面的显示状态。通过QStackedWidget，可以在不占用额外空间的情况下，实现多页面切换的功能，从而提高了用户界面的灵活性和可用性。

二、使用范围

QStackedWidget广泛应用于需要多页面切换功能的场景，如向导式界面、设置对话框、多步骤表单、图片查看器等。它使得用户可以在不同的功能区域之间轻松切换，同时保持了界面的整洁和一致性。

三、类的头文件

QStackedWidget的头文件为<QStackedWidget>，使用时需要包含该头文件。

#include <QStackedWidget>

四、类的注意事项

QStackedWidget中的每个页面都对应一个QWidget或QLayout。
页面切换时，只有当前页面是可见的，其他页面都被隐藏。
QStackedWidget支持动态添加和删除页面。
页面切换可以通过编程方式（如调用setCurrentIndex()）或用户交互（如连接信号到槽函数）来实现。
QStackedWidget的页面索引是从0开始的。

五、类的继承

QStackedWidget继承自QFrame，是一个可以包含多个页面的容器控件。由于QFrame继承自QWidget，因此QStackedWidget也是一个QWidget，可以像其他QWidget一样被添加到布局中或作为其他控件的子控件。

六、类的构造介绍

QStackedWidget的构造函数有两种重载形式：

QStackedWidget(QWidget *parent = nullptr);
QStackedWidget(int count, QWidget *parent = nullptr);

parent：父组件，默认为nullptr。
count：初始页面数量，默认为0。如果指定了数量，QStackedWidget会预先创建这么多空页面，但页面内容需要开发者后续添加。

七、公有函数介绍

QStackedWidget提供了一系列公有函数，用于设置和获取其属性：

int addWidget(QWidget *widget)：添加一个页面，并返回其索引。
int insertWidget(int index, QWidget *widget)：在指定位置插入一个页面，并返回其索引。
void removeWidget(int index)：移除指定位置的页面。页面不会被删除，只是从QStackedWidget中移除。
QWidget *widget(int index) const：获取指定位置的页面。
int currentIndex() const：获取当前显示页面的索引。
void setCurrentIndex(int index)：设置当前显示页面的索引。
int count() const：获取页面总数。

八、重新实现的公有函数

QStackedWidget通常不需要开发者重新实现其公有函数，因为它已经提供了足够的功能来管理页面。然而，由于QStackedWidget继承自QWidget（通过QFrame），因此它继承了一些QWidget的虚函数，这些函数在某些情况下可能会被重新实现以提供自定义行为。但在大多数情况下，开发者只需要使用QStackedWidget提供的公有API来操作其页面即可。

九、信号与槽

QStackedWidget没有提供特定的信号来通知页面切换事件。然而，由于它继承自QWidget，因此可以连接QWidget的信号（如destroyed()）到槽函数来响应某些事件。此外，开发者可以通过编程方式在切换页面前后执行自定义代码来实现类似信号的功能。

为了响应页面切换事件，开发者可以在调用setCurrentIndex()之前或之后添加自定义代码。例如，可以在切换页面之前保存当前页面的状态，在切换页面之后加载新页面的状态。

十、重新实现的受保护函数

与重新实现的公有函数类似，QStackedWidget的受保护函数通常也不需要开发者重新实现。这些函数通常用于QStackedWidget的内部机制，如绘制、事件处理等。然而，如果开发者需要自定义QStackedWidget的某些行为（如绘制自定义的背景或边框），他们可能会考虑重新实现这些受保护函数。但在大多数情况下，这是不必要的，因为QStackedWidget已经提供了丰富的API来满足大多数需求。

十一、详细代码举例

以下是一个使用QStackedWidget的C++示例代码，演示了如何创建一个包含多个页面的QStackedWidget，并将其添加到一个主窗口中。

#include <QApplication>
#include <QStackedWidget>
#include <QVBoxLayout>
#include <QWidget>
#include <QLabel>
#include <QPushButton>

int main(int argc, char *argv[]) {
    QApplication app(argc, argv);

    // 创建主窗口
    QWidget window;
    window.setWindowTitle("QStackedWidget 示例");
    window.resize(400, 300);  // 设置窗口大小

    // 创建一个垂直布局
    QVBoxLayout *layout = new QVBoxLayout(&window);

    // 创建一个QStackedWidget
    QStackedWidget *stackedWidget = new QStackedWidget(&window);

    // 创建第一个页面
    QWidget *page1 = new QWidget();
    QVBoxLayout *page1Layout = new QVBoxLayout(page1);
    QPushButton *button = new QPushButton("去第二个页面", page1); // 修改按钮文本以更清晰地表达其功能
    page1Layout->addWidget(button);

    // 创建第二个页面
    QWidget *page2 = new QWidget();
    QVBoxLayout *page2Layout = new QVBoxLayout(page2);
    QLabel *label2 = new QLabel("这是第二个页面", page2);
    page2Layout->addWidget(label2);

    // 将页面添加到QStackedWidget中
    stackedWidget->addWidget(page1);
    stackedWidget->addWidget(page2);

    // 连接按钮的点击信号到槽函数，用于切换页面
    QObject::connect(button, &QPushButton::clicked, [stackedWidget](){
        stackedWidget->setCurrentIndex(1); // 切换到第二个页面
    });

    // 初始显示第一个页面
    stackedWidget->setCurrentIndex(0);

    // 将QStackedWidget添加到主窗口的布局中
    layout->addWidget(stackedWidget);

    // 显示主窗口
    window.show();

    return app.exec();
}

在这个示例中，我们创建了一个QStackedWidget，并添加了两个页面。第一个页面包含一个QLabel，用于显示文本；第二个页面也包含一个QLabel和一个QPushButton。我们连接了按钮的点击信号到一个lambda函数，该函数将QStackedWidget的当前页面切换回第一个页面。最后，我们将QStackedWidget添加到主窗口的QVBoxLayout中，并显示了主窗口。

通过QStackedWidget，我们可以轻松地在不同的页面之间切换，从而提高了用户界面的组织性和可用性。同时，由于QStackedWidget只显示当前页面，因此它还有助于节省屏幕空间。

何曾参静谧的博客（✅关注、👍点赞、⭐收藏、👻转发）

在这里插入图片描述