一杯清酒邀明月
天下本无事,庸人扰之而烦耳。

简述
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()来设置需要显示的页面。

posted on 2022-04-20 16:37  一杯清酒邀明月  阅读(470)  评论(0编辑  收藏  举报