18、 QStackedWidget

Chiang木

已于 2022-09-20 23:05:24 修改

阅读量1.2k

点赞数

CC 4.0 BY-SA版权

分类专栏： QT教程文章标签：引用传递 c++ asp.net

于 2019-10-20 16:22:18 首次发布

原文链接：https://blog.youkuaiyun.com/yellow_hill/article/details/72848844

QT教程专栏收录该内容

42 篇文章

订阅专栏

本文详细介绍了QStackedWidget类的功能与使用方法，包括页面切换、添加与移除页面等操作，展示了如何通过示例代码实现类似QTabWidget的用户界面效果。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

简述

QStackedWidget继承自QFrame。

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

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

接口

int addWidget(QWidget * widget)- 添加页面，并返回页面对应的索引

int count() const -获取页面数量

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

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

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

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

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

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页面为当前页面

示例：

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);
}