QStackedWidget 是 Qt 框架中提供的一个非常有用的控件，主要用于在同一个窗口区域切换显示多个窗口组件。它可以看作是一个“窗口栈”，其中每个子窗口称为一个“页面”。以下是关于 QStackedWidget 的详细解释：

基本特点

1. 页面堆栈：QStackedWidget 管理一组 widget，用户可以在这些 widget 之间切换，但是在同一时刻，只能看到一个 widget。

2. 添加和移除页面：

   • 通过 addWidget() 函数将新的页面添加到 QStackedWidget 中。
   • 通过 removeWidget() 函数可以移除已有的页面。

3. 页面切换：

   • 使用 setCurrentIndex(int index) 可以通过索引切换页面。
   • 使用 setCurrentWidget(QWidget *widget) 可以通过传递 widget 指针切换页面。

4. 获取当前页面：

   • currentIndex() 返回当前显示页面的索引。
   • currentWidget() 返回当前显示的 widget。

5. 信号与槽：

   • QStackedWidget 发出 currentChanged(int index) 信号，当页面切换时会触发该信号。
   • 可以将该信号连接到槽函数，以在页面切换时执行特定操作。

使用场景

• 分步式表单：在逐步填写表单的应用程序中，可以使用 QStackedWidget 根据用户输入显示不同的页面。

• 选项卡界面：结合其他控件如 QTabBar 使用，可以创建选项卡式界面。

• 多视图应用：在需要动态切换视图的应用程序中，QStackedWidget 是一个方便的选择。

示例代码

以下是一个简单的示例，展示如何使用 QStackedWidget：

#include <QApplication>  
#include <QStackedWidget>  
#include <QWidget>  
#include <QPushButton>  
#include <QVBoxLayout>  
#include <QHBoxLayout>  
int main(int argc, char *argv[]) {  
    QApplication app(argc, argv);  
    QWidget window;  
    QVBoxLayout *layout = new QVBoxLayout(&window);  
    // 创建 QStackedWidget  
    QStackedWidget *stackedWidget = new QStackedWidget;  
    // 创建页面  
    QWidget *page1 = new QWidget;  
    QVBoxLayout *layout1 = new QVBoxLayout(page1);  
    layout1->addWidget(new QPushButton("Page 1 Button"));  
    QWidget *page2 = new QWidget;  
    QVBoxLayout *layout2 = new QVBoxLayout(page2);  
    layout2->addWidget(new QPushButton("Page 2 Button"));  
    // 添加页面到 QStackedWidget  
    stackedWidget->addWidget(page1);  
    stackedWidget->addWidget(page2);  
    // 切换按钮  
    QPushButton *prevButton = new QPushButton("Previous");  
    QPushButton *nextButton = new QPushButton("Next");  
    // 连接按钮与切换功能  
    QObject::connect(nextButton, &QPushButton::clicked, [&]() {  
        int currentIndex = stackedWidget->currentIndex();  
        int nextIndex = (currentIndex + 1) % stackedWidget->count();  
        stackedWidget->setCurrentIndex(nextIndex);  
    });  
    QObject::connect(prevButton, &QPushButton::clicked, [&]() {  
        int currentIndex = stackedWidget->currentIndex();  
        int prevIndex = (currentIndex - 1 + stackedWidget->count()) % stackedWidget->count();  
        stackedWidget->setCurrentIndex(prevIndex);  
    });  
    QHBoxLayout *buttonLayout = new QHBoxLayout;  
    buttonLayout->addWidget(prevButton);  
    buttonLayout->addWidget(nextButton);  
    // 添加组件到主布局  
    layout->addWidget(stackedWidget);  
    layout->addLayout(buttonLayout);  
    window.show();  
    return app.exec();  
}  

在这个示例中，我们创建了一个包含两个页面的 QStackedWidget，并通过两个按钮进行页面切换。希望这可以帮助你更好地理解 QStackedWidget 的使用场景和方法。