【Qt笔记】QStackedWidget控件详解

页面堆叠：QStackedWidget通过堆叠的方式管理多个页面（子部件），每个页面都有一个唯一的索引值。只有当前索引对应的页面是可见的，其他页面则会被隐藏。
动态切换：开发者可以通过设置当前索引或当前子部件来动态地切换显示的页面。这种切换是即时的，且可以响应各种事件或用户操作。
灵活布局：QStackedWidget本身并不提供布局管理功能，但它可以与其他布局管理器（如QVBoxLayout、QHBoxLayout等）结合使用，以实现复杂的界面布局。

二、属性设置

2.1 属性介绍

虽然QStackedWidget没有像QWidget那样众多的属性需要直接设置，但它通过其API函数提供了丰富的控制手段。以下是一些与属性设置相关的要点：

当前页面索引（currentIndex）：这是一个只读属性，用于获取当前显示的页面的索引值。虽然不能直接设置该属性，但可以通过调用setCurrentIndex()函数来改变当前页面。
当前页面（currentWidget）：这同样是一个只读属性，返回当前显示的页面的指针。同样地，不能直接设置该属性，但可以通过setCurrentWidget()函数来改变当前页面。
页面计数（count）：这是一个只读属性，返回QStackedWidget中子部件的数量。这有助于在编程时遍历或检查子部件。

2.2 代码示例

以下是为QStackedWidget的currentIndex、currentWidget和count属性提供代码示例的方式。需要注意的是，由于currentIndex和currentWidget是只读属性，我们不能直接“设置”它们，但可以通过调用相关函数来改变它们所代表的状态。

#include <QApplication>  
#include <QStackedWidget>  
#include <QPushButton>  
#include <QVBoxLayout>  
#include <QWidget>  
#include <QLabel>  
  
int main(int argc, char *argv[]) {  
    QApplication app(argc, argv);  
  
    // 创建主窗口  
    QWidget window;  
    QVBoxLayout *layout = new QVBoxLayout(&window);  
  
    // 创建QStackedWidget  
    QStackedWidget *stackedWidget = new QStackedWidget;  
  
    // 添加几个页面到QStackedWidget  
    QWidget *page1 = new QWidget;  
    QLabel *label1 = new QLabel("Page 1", page1);  
    QVBoxLayout *page1Layout = new QVBoxLayout(page1);  
    page1Layout->addWidget(label1);  
  
    QWidget *page2 = new QWidget;  
    QLabel *label2 = new QLabel("Page 2", page2);  
    QVBoxLayout *page2Layout = new QVBoxLayout(page2);  
    page2Layout->addWidget(label2);  
  
    QWidget *page3 = new QWidget;  
    QLabel *label3 = new QLabel("Page 3", page3);  
    QVBoxLayout *page3Layout = new QVBoxLayout(page3);  
    page3Layout->addWidget(label3);  
  
    stackedWidget->addWidget(page1);  
    stackedWidget->addWidget(page2);  
    stackedWidget->addWidget(page3);  
  
    // 将QStackedWidget添加到主窗口布局  
    layout->addWidget(stackedWidget);  
  
    // 创建按钮来切换页面  
    QPushButton *prevButton = new QPushButton("Previous");  
    QPushButton *nextButton = new QPushButton("Next");  
    QHBoxLayout *buttonLayout = new QHBoxLayout;  
    buttonLayout->addWidget(prevButton);  
    buttonLayout->addWidget(nextButton);  
    layout->addLayout(buttonLayout);  
  
    // 初始时禁用“Previous”按钮  
    prevButton->setEnabled(false);  
  
    // 连接信号与槽以切换页面  
    QObject::connect(nextButton, &QPushButton::clicked, [stackedWidget, prevButton]() {  
        int currentIndex = stackedWidget->currentIndex();  
        if (currentIndex < stackedWidget->count() - 1) {  
            stackedWidget->setCurrentIndex(currentIndex + 1);  
            prevButton->setEnabled(true);  
        }  
    });  
  
    QObject::connect(prevButton, &QPushButton::clicked, [stackedWidget]() {  
        int currentIndex = stackedWidget->currentIndex();  
        if (currentIndex > 0) {  
            stackedWidget->setCurrentIndex(currentIndex - 1);  
            if (currentIndex == 1) {  
                // 在这个简单的例子中，我们总是启用“Previous”按钮  
                // 但在更复杂的应用中，你可能需要根据实际情况来决定是否禁用它  
            }  
        }  
    });  
  
    // 示例：打印当前页面索引和页面计数  
    qDebug() << "Initial current index:" << stackedWidget->currentIndex();  
    qDebug() << "Total page count:" << stackedWidget->count();  
  
    // 示例：通过currentWidget获取当前页面并打印其标签文本（假设标签是页面的直接子部件）  
    if (QLabel *currentLabel = stackedWidget->currentWidget()->findChild<QLabel*>()) {  
        qDebug() << "Current page label text:" << currentLabel->text();  
    }  
  
    window.setWindowTitle("QStackedWidget Example");  
    window.resize(400, 300);  
    window.show();  
    return app.exec();  
}

2.3 代码解析

在这个示例中：

我们创建了一个QStackedWidget并向其中添加了三个页面。
每个页面都是一个包含QLabel的QWidget。
我们添加了两个按钮来在页面之间切换，并根据当前页面索引启用或禁用“Previous”按钮。
使用qDebug()打印了初始的当前页面索引和页面总数，展示了如何访问这些只读属性。
我们还展示了如何通过currentWidget()获取当前页面，并使用findChild<QLabel*>()查找并打印当前页面上QLabel的文本（注意：这种方法假设QLabel是页面的直接子部件，且页面上只有一个QLabel）。在实际应用中，你可能需要更复杂的逻辑来定位特定的子部件。

三、常用API

QStackedWidget提供了丰富的API函数，以便开发者能够灵活地管理和控制其包含的页面。以下是一些常用的API函数及其说明：

3.1 添加子部件

addWidget(QWidget *widget, int index = -1)：向QStackedWidget中添加一个子部件。如果指定了索引（index），则子部件将被插入到该索引位置；如果未指定索引（或指定为-1），则子部件将被添加到末尾。

// 创建一个主窗口  
QWidget window;  
QVBoxLayout *layout = new QVBoxLayout(&window);  
  
// 创建一个QStackedWidget  
QStackedWidget *stackedWidget = new QStackedWidget;  
  
// 创建几个页面  
QWidget *page1 = new QWidget;  
QLabel *label1 = new QLabel("Page 1", page1);  
QVBoxLayout *page1Layout = new QVBoxLayout(page1);  
page1Layout->addWidget(label1);  
  
QWidget *page2 = new QWidget;  
QLabel *label2 = new QLabel("Page 2", page2);  
QVBoxLayout *page2Layout = new QVBoxLayout(page2);  
page2Layout->addWidget(label2);  

QWidget *page3 = new QWidget;  
QLabel *label3 = new QLabel("Page 3", page3);  
QVBoxLayout *page3Layout = new QVBoxLayout(page3);  
page3Layout->addWidget(label3);  
  
// 使用addWidget添加页面到末尾  
stackedWidget->addWidget(page1);  
stackedWidget->addWidget(page2);

3.2 插入子部件

insertWidget(int index, QWidget *widget)：在指定索引处插入一个子部件。如果索引超出当前范围，则子部件将被添加到末尾。

// 使用insertWidget在指定索引处插入页面  
stackedWidget->insertWidget(1, page3); // 这将page3插入到page1和page2之间

3.3 移除子部件

removeWidget(QWidget *widget)：从QStackedWidget中移除一个子部件。子部件本身不会被删除，只是从布局中移除，从而被隐藏。

// 假设现在想要移除page2  
stackedWidget->removeWidget(page2);

3.4 设置当前页面索引值

setCurrentIndex(int index)：设置当前显示的页面的索引值。如果索引值超出范围，则不会改变当前页面。

// 设置当前页面索引  
stackedWidget->setCurrentIndex(0); // 显示page1

3.5 设置当前显示子部件

setCurrentWidget(QWidget *widget)：设置当前显示的子部件。如果指定的子部件已经存在于QStackedWidget中，则它将成为当前页面；如果不存在，则什么也不会发生。

3.6 返回索引处子部件指针

widget(int index)：返回指定索引处的子部件的指针。如果索引超出范围，则返回nullptr。

// 获取并显示指定索引处的子部件  
QWidget *currentPage = stackedWidget->widget(0);  
if (currentPage) {  
    QLabel *currentLabel = currentPage->findChild<QLabel*>();  
    if (currentLabel) {  
        qDebug() << "Current page label text:" << currentLabel->text();  
    }  
}

3.7 返回子部件索引值

indexOf(QWidget *widget)：返回子部件在QStackedWidget中的索引值。如果子部件不存在于QStackedWidget中，则返回-1。

// 获取子部件在QStackedWidget中的索引  
int index = stackedWidget->indexOf(page3);  
qDebug() << "Index of page3:" << index; // 应该输出1，除非在添加/移除后修改了索引

四、信号与槽

QStackedWidget还提供了几个信号，以便在页面切换或页面被移除时通知开发者。这些信号可以与槽函数（即回调函数）连接，以执行特定的操作。

4.1 currentChanged

currentChanged(int index)：当当前显示的页面改变时发射。参数index是新显示的页面的索引值。

// 连接currentChanged信号  
connect(stackedWidget, &QStackedWidget::currentChanged, this, [=](int index) {  
    qDebug() << "Current page changed to index:" << index;  
});

4.2 widgetRemoved

widgetRemoved(int index)：当一个小部件（页面）从QStackedWidget中移除时发射。参数是被移除的小部件的索引值。

// 连接widgetRemoved信号  
connect(stackedWidget, &QStackedWidget::widgetRemoved, this, [=](int index) {  
    qDebug() << "Widget removed from index:" << index;  
});

五、应用示例

5.1 代码

以下是一个简化的向导示例，展示了如何使用QStackedWidget来实现一个多步骤的向导界面。

#include <QApplication>  
#include <QStackedWidget>  
#include <QLabel>  
#include <QPushButton>  
#include <QVBoxLayout>  
#include <QHBoxLayout>  
  
class Wizard : public QWidget {  
    Q_OBJECT  
public:  
    Wizard(QWidget *parent = nullptr) : QWidget(parent) {  
        auto *stackedWidget = new QStackedWidget(this);  
  
        // 创建向导页面  
        QWidget *page1 = createPage("Welcome", "This is the first page of the wizard.");  
        QWidget *page2 = createPage("Name", "Enter your name:");  
        QWidget *page3 = createPage("Finish", "Thank you! You have completed the wizard.");  
  
        stackedWidget->addWidget(page1);  
        stackedWidget->addWidget(page2);  
        stackedWidget->addWidget(page3);  
  
        // 导航按钮  
        auto *backButton = new QPushButton("Back", this);  
        auto *nextButton = new QPushButton("Next", this);  
  
        // 禁用“后退”按钮在第一页  
        backButton->setEnabled(false);  
  
        // 布局  
        auto *mainLayout = new QVBoxLayout(this);  
        mainLayout->addWidget(stackedWidget);  
  
        auto *buttonLayout = new QHBoxLayout();  
        buttonLayout->addWidget(backButton);  
        buttonLayout->addWidget(nextButton);  
        mainLayout->addLayout(buttonLayout);  
  
        // 连接信号和槽  
        connect(nextButton, &QPushButton::clicked, [=]() {  
            if(nextButton->text() == "Finish")
            {
                this->close();
            }
            int currentIndex = stackedWidget->currentIndex();  
            if (currentIndex < stackedWidget->count() - 1) {  
                stackedWidget->setCurrentIndex(currentIndex + 1);  
                if (currentIndex == 1) { // 假设第二页是最后一页需要处理的  
                    // 在这里处理用户输入，如验证名称等  
                    // ...  
                }  
                backButton->setEnabled(true);  
                if (currentIndex == stackedWidget->count() - 2) {  
                    // 在最后一页设置“下一步”按钮文本
                    nextButton->setText("Finish");   
                }  
            }  
        });  
  
        connect(backButton, &QPushButton::clicked, [=]() {  
            int currentIndex = stackedWidget->currentIndex();  
            if (currentIndex > 0) {  
                stackedWidget->setCurrentIndex(currentIndex - 1);  
                backButton->setEnabled(currentIndex > 0);  
                if (currentIndex == 1) {  
                    nextButton->setText("Next");  
                    nextButton->setEnabled(true);  
                }  
            }  
        });  
  
        // 初始显示第一步  
        stackedWidget->setCurrentIndex(0);  
    }  
  
private:  
    QWidget *createPage(const QString &title, const QString &text) {  
        QWidget *page = new QWidget();  
        QLabel *label = new QLabel(text, page);  
        QVBoxLayout *layout = new QVBoxLayout(page);  
        layout->addWidget(new QLabel(title, page));  
        layout->addWidget(label);  
        return page;  
    }  
};  
  
// ... (main函数和QApplication的实例化)

5.2 实现效果

5.3 代码解析

在这个示例中，我们创建了一个简单的向导，它有三个页面：欢迎页、名称输入页和完成页。通过createPage辅助函数，我们简化了页面创建的过程。导航按钮根据当前页面的索引启用或禁用，并在最后一页时将“下一步”按钮的文本更改为“完成”并且在判断识别到文本更改为”Finsh“，并点击时，关闭窗口。这个示例展示了如何在页面切换时执行简单的逻辑，并管理按钮的启用/禁用状态。

结语

QStackedWidget是Qt框架中一个非常实用的控件，它允许开发者在一个固定区域内堆叠多个子窗口或页面，并通过切换来显示不同的内容。通过使用QStackedWidget，我们可以轻松地创建多页的用户界面，如向导、选项卡等。希望本文的详细解析和示例代码能够帮助你更好地理解和使用QStackedWidget。

原文地址：https://blog.csdn.net/qq_52924376/article/details/142460188

免责声明：本站文章内容转载自网络资源，如本站内容侵犯了原著者的合法权益，可联系本站删除。更多内容请关注自学内容网（zxcms.com）！

上一篇：prompt攻击与防范
下一篇：Apache Druid命令执行（CVE-2021-25646）

GetThreadSelectorEntry teb peb 段选择子 LDT_ENTRY _LDT_ENTRY
GetThreadSelectorEntry teb peb 段选择子 LDT_ENTRY _LDT_ENTRY
阅读更多2024-09-27
SD卡认识——SDIO协议入门与实践（一）
经常用sd卡会在卡的正面看到，**SD、SDHC、SDXC**的字样，一般用户也不太关心这些，但如果要搞sd卡相关开发，还是要了解一二的
阅读更多2024-09-27
HTAP 数据库的应用场景：是否被过度夸大？
HTAP 数据库的应用场景：是否被过度夸大？
阅读更多2024-09-27
美国林氏集团宣布全面进军Web3领域
吉隆坡，马来西亚——近日举行的第六界博览会上，美国林氏集团董事局主席林建中先生宣布，集团将通过旗下的大东亚银行创建一个全新的、合规的区块链交易所，并正式进军Web3、元宇宙及AI领域。同时，美国林氏集
阅读更多2024-09-27
Mysql之索引优化
指定索引适合开发者手动介入优化查询。覆盖索引能够在频繁查询特定列时，避免回表，提升查询效率，是性能优化的重要手段。前缀索引适用于长文本字段，能在保证索引效率的同时，减少存储开销。
阅读更多2024-09-27
Linux上的C/C++编程
vim，gcc，make/makefile，gdb
阅读更多2024-09-27
从耐用到防水：全面综合评估SD卡的性能指标
SD卡（Secure Digital Memory Card）是一种广泛使用的存储器件，因其快速的数据传输速度、可热插拔的特性以及较大的存储容量，广泛应用于各种场景，例如在便携式设备如智能手机、平板电
阅读更多2024-09-27
JSON 教程
【代码】JSON 教程。
阅读更多2024-09-27
ThreeJs绘制圆柱体
Threejs可以方便地创建各种不同尺寸和外观的圆柱体，可应用于构建机械模型、建筑结构、柱状物体等场景。是用于创建圆柱体几何形状的类。圆柱体在三维图形中是一种常见的基本形状。
阅读更多2024-09-27
MongoDB-索引的使用和索引类型
非常详细的MongoDB的索引介绍，针对MongoDB的索引大致可以分为，唯一索引、单列索引、多列索引（复合索引）、多键索引（数组字段索引）、文本搜索索引、地理空间索引，等。
阅读更多2024-09-27