QStackedWidget——一个界面中多页面切换

QStackedWidget

QStackedWidget继承自QFrame。

QStackedWidget类提供了多页面切换的布局，一次只能看到一个界面。

QStackedWidget可用于创建类似于QTabWidget提供的用户界面。
接口

添加页面，并返回页面对应的索引
int addWidget(QWidget * widget)
   
获取页面数量
int count() const

获取当前页面的索引
int currentIndex() const

获取当前页面
QWidget * currentWidget() const

获取QWidget页面所对应的索引
int indexOf(QWidget * widget) const

在索引index位置添加页面
int insertWidget(int index, QWidget * widget)

移除QWidget页面，并没有被删除，只是从布局中移动，从而被隐藏。
void removeWidget(QWidget * widget)

获取索引index所对应的页面
QWidget * widget(int index) const 

信号

当前页面发生变化时候发射，index为新的索引值
void currentChanged(int index)

页面被移除时候发射，index为页面对应的索引值
void widgetRemoved(int index)    

共有槽函数

设置索引index所在的页面为当前页面
void setCurrentIndex(int index)

 设置QWidget页面为当前页面
void setCurrentWidget(QWidget * widget)

总结

一般情况，常用的两种方式：

根据currentWidget()来判断当前页面，然后通过setCurrentWidget()来设置需要显示的页面。

根据currentIndex()来判断当前页面索引，然后通过setCurrentIndex()来设置需要显示的页面。

Qt使用QStackedWidget实现堆栈窗口

堆栈窗口可以根据选择项的不同显示不同的窗体

stackeddlg.h

 #ifndef STACKEDDLG_H
    #define STACKEDDLG_H
     
    #include 
    #include 
    #include 
    #include 
     
    class StackedDlg : public QDialog
    {
        Q_OBJECT
    public:
        explicit StackedDlg(QWidget *parent = 0);
    signals:
    public slots:
     
    private:
        QLabel *textLabel;
        QLabel *showLabel;
        QLabel *aboutLabel;
        QListWidget *list;
        QStackedWidget *stack;
    };
    #endif // STACKEDDLG_H

stackeddlg.cpp

 #include "stackeddlg.h"
 #include 
     
    StackedDlg::StackedDlg(QWidget *parent) :
        QDialog(parent)
    {
        //创建一个QListWidget控件 并向其中添加列表项
        list = new QListWidget();
        list->insertItem(0, tr("文本窗口"));
        list->insertItem(1, tr("显示窗口"));
    	list->insertItem(2, tr("关于窗口"));
    	
        textLabel = new QLabel(tr("学习使用堆栈窗口"));
        showLabel = new QLabel(tr("仅仅是一个示例程序"));
    	aboutLabel = new QLabel(tr("欢迎交流,共同学习"));
    	
        //创建QStackedwidget控件
        stack = new QStackedWidget();
        //将控件添加到堆栈窗口中
        stack->addWidget(textLabel);
        stack->addWidget(showLabel);
    	stack->addWidget(aboutLabel);
    	
        //使用一个水平布局管理器对对话框进行布局
        QHBoxLayout *mainLayout = new QHBoxLayout(this);
        mainLayout->addWidget(list);
        mainLayout->addWidget(stack, 0, Qt::AlignHCenter);
        //设置mainLayout的边框与对话框边缘的距离
        mainLayout->setMargin(5);
        mainLayout->setSpacing(5);
        //信号与槽的连接，实现按选择显示窗体
        //此处堆栈窗口的index按插入的顺序从0依次排序，与QListWidget的条目排序一致
    	connect(list, SIGNAL(currentRowChanged(int)), stack, SLOT(setCurrentIndex(int)));
    	
        this->setWindowTitle(tr("堆栈窗口"));
    }

main.cpp

    #include 
    #include 
    #include "stackeddlg.h"
    int main(int argc, char *argv[])
    {
        QTextCodec::setCodecForTr(QTextCodec::codecForLocale());
        QApplication app(argc, argv);
        StackedDlg dlg;
        dlg.show();
        return app.exec();
    }

QPushButton *pButton = new QPushButton(this);
QLabel *pFirstPage= new QLabel(this);
QLabel *pSecondPage = new QLabel(this);
QLabel *pThirdPage = new QLabel(this);
m_pStackedWidget = new QStackedWidget(this);

pButton->setText(QStringLiteral("点击切换"));
pFirstPage->setText(QStringLiteral("一去丶二三里"));
pSecondPage->setText(QStringLiteral("青春不老，奋斗不止！"));
pThirdPage->setText(QStringLiteral("纯正开源之美，有趣、好玩、靠谱。。。"));

// 添加页面（用于切换）
m_pStackedWidget->addWidget(pFirstPage);
m_pStackedWidget->addWidget(pSecondPage);
m_pStackedWidget->addWidget(pThirdPage);

QVBoxLayout *pLayout = new QVBoxLayout();
pLayout->addWidget(pButton, 0, Qt::AlignLeft | Qt::AlignVCenter);
pLayout->addWidget(m_pStackedWidget);
pLayout->setSpacing(10);
pLayout->setContentsMargins(10, 10, 10, 10);
setLayout(pLayout);

// 连接切换按钮信号与槽
connect(pButton, &QPushButton::clicked, this, &MainWindow::switchPage);

// 切换页面
void MainWindow::switchPage()
{
    int nCount = m_pStackedWidget->count();
    int nIndex = m_pStackedWidget->currentIndex();

    // 获取下一个需要显示的页面索引
    ++nIndex;

    // 当需要显示的页面索引大于等于总页面时，切换至首页
    if (nIndex >= nCount)
        nIndex = 0;

    m_pStackedWidget->setCurrentIndex(nIndex);
}