简述
QStackedLayout继承自QLayout。
QStackedLayout类提供了多页面切换的布局,一次只能看到一个界面。
QStackedLayout可用于创建类似于QTabWidget提供的用户界面。也有建立在QStackedLayout之上的便利类QStackedWidget。
使用
一个QStackedLayout可以用一些子页面进行填充。
效果
1 QPushButton *pButton = new QPushButton(this);
2 QLabel *pFirstPage= new QLabel(this);
3 QLabel *pSecondPage = new QLabel(this);
4 QLabel *pThirdPage = new QLabel(this);
5 m_pStackedLayout = new QStackedLayout();
6
7 pButton->setText(QStringLiteral("点击切换"));
8 pFirstPage->setText(QStringLiteral("一去丶二三里"));
9 pSecondPage->setText(QStringLiteral("青春不老,奋斗不止!"));
10 pThirdPage->setText(QStringLiteral("纯正开源之美,有趣、好玩、靠谱。。。"));
11
12 // 添加页面(用于切换)
13 m_pStackedLayout->addWidget(pFirstPage);
14 m_pStackedLayout->addWidget(pSecondPage);
15 m_pStackedLayout->addWidget(pThirdPage);
16
17 QVBoxLayout *pLayout = new QVBoxLayout();
18 pLayout->addWidget(pButton, 0, Qt::AlignLeft | Qt::AlignVCenter);
19 pLayout->addLayout(m_pStackedLayout);
20 pLayout->setSpacing(10);
21 pLayout->setContentsMargins(10, 10, 10, 10);
22 setLayout(pLayout);
23
24 // 连接切换按钮信号与槽
25 connect(pButton, &QPushButton::clicked, this, &MainWindow::switchPage);
26
27 // 切换页面
28 void MainWindow::switchPage()
29 {
30 int nCount = m_pStackedLayout->count();
31 int nIndex = m_pStackedLayout->currentIndex();
32
33 // 获取下一个需要显示的页面索引
34 ++nIndex;
35
36 // 当需要显示的页面索引大于等于总页面时,切换至首页
37 if (nIndex >= nCount)
38 nIndex = 0;
39
40 m_pStackedLayout->setCurrentIndex(nIndex);
41 }
接口
int addWidget(QWidget * widget)
添加页面,并返回页面对应的索引
int currentIndex() const
获取当前页面的索引
QWidget * currentWidget() const
获取当前页面
int insertWidget(int index, QWidget * widget)
在索引index位置添加页面
void setStackingMode(StackingMode stackingMode)
设置显示模式,StackingMode有两个值,一个是StackOne(默认-显示一个页面),一个是StackAll(显示所有页面),一般不使用。
QWidget * widget(int index) const
获取索引index所对应的页面
信号
void currentChanged(int index)
当前页面发生变化时候发射,index为新的索引值
void widgetRemoved(int index)
页面被移除时候发射,index为页面对应的索引值
共有槽函数
void setCurrentIndex(int index)
设置索引index所在的页面为当前页面
void setCurrentWidget(QWidget * widget)
设置QWidget页面为当前页面
总结
一般情况,常用的两种方式:
根据currentWidget()来判断当前页面,然后通过setCurrentWidget()来设置需要显示的页面。
根据currentIndex()来判断当前页面索引,然后通过setCurrentIndex()来设置需要显示的页面。