【Qt笔记】QStackedWidget控件详解

目录

引言

一、基础功能

二、属性设置

2.1 属性介绍

2.2 代码示例 

2.3 代码解析

三、常用API

3.1 添加子部件

3.2 插入子部件

3.3 移除子部件

3.4 设置当前页面索引值

3.5 设置当前显示子部件

3.6 返回索引处子部件指针

3.7 返回子部件索引值

四、信号与槽

4.1 currentChanged

4.2 widgetRemoved

五、应用示例

5.1 代码 

5.2 实现效果

5.3 代码解析

结语

引言

QStackedWidget是 Qt 框架中的一个非常有用的控件，它允许你堆叠多个窗口部件（widgets），但一次只显示一个。这种机制非常适合于实现向导、多视图应用程序、选项卡界面（虽然它没有内置的选项卡头）以及表单向导等场景。通过改变当前索引，可以轻松地切换显示的窗口部件。

 

一、基础功能

QStackedWidget是Qt框架中的一个容器控件，用于在同一区域内动态地堆叠和显示不同的子部件（如窗口、对话框、页面等）。它一次只显示一个子部件，但允许开发者通过编程方式轻松地在这些子部件之间切换。

  • 页面堆叠：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。 

 

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：http://www.xdnf.cn/news/148110.html

如若内容造成侵权/违法违规/事实不符，请联系一条长河网进行投诉反馈，一经查实，立即删除！

相关文章

蓝牙AOA基站助力打造智慧医院管理系统

蓝牙AOA基站助力打造智慧医院管理系统

随着科技的飞速发展&#xff0c;智慧医院的概念逐渐深入人心。其中&#xff0c;蓝牙AOA&#xff08;到达角&#xff09;定位技术以其高精度、低功耗、低成本等优势&#xff0c;在智慧医院建设中扮演着重要角色。本文将深入探讨蓝牙AOA基站如何助力智慧医院的建设与发展。 一、蓝…
阅读更多...
Linux C高级 day4

Linux C高级 day4

一、思维导图 二、练习 1、统计家目录下.c文件的个数 #!/bin/bashcount0 for file in ~/*.cdo((count)) done echo $count 2、定义一个稀疏数组(下标不连续)&#xff0c;写一个函数&#xff0c;求该稀疏数组的和&#xff0c;要求稀疏数组中的数值通过参数传递到函数中。arr(…
阅读更多...
【例题】证明极限

【例题】证明极限

已知&#xff1a; ∀ ε > 0 , ∃ n > N , ∣ a n − A ∣ < ε \forall \varepsilon >0, \exist n>N,|a_n-A|<\varepsilon ∀ε>0,∃n>N,∣an​−A∣<ε 目标&#xff1a; ∀ ε > 0 , ∃ n > N 1 , ∣ a 1 . . . a n n − A ∣ < ε \…
阅读更多...
codeforces round974 div3 分层图 树形dp

codeforces round974 div3 分层图 树形dp

A Robin Helps 问题&#xff1a; 思路&#xff1a;模拟 代码&#xff1a; #include <bits/stdc.h> using namespace std;const int N 2e5 10;void solve() {int n, k;cin >> n >> k;vector<int> a(n 1);for(int i 1; i < n; i ) cin >&…
阅读更多...
9.23 My_string.cpp

9.23 My_string.cpp

my_string.h #ifndef MY_STRING_H #define MY_STRING_H#include <iostream> #include <cstring>using namespace std;class My_string { private:char *ptr; //指向字符数组的指针int size; //字符串的最大容量int len; //字符串当前…
阅读更多...
车载视频监控：安全生产与管理的新趋势

车载视频监控：安全生产与管理的新趋势

随着社会的快速发展&#xff0c;车载视频监控技术已成为现代安防领域不可或缺的一部分。车载视频监控设备是专为车载安防设计的新型视频监控设备&#xff0c;其安装已经成为社会发展的必然趋势。对于企业的安全生产和管理来说&#xff0c;车载视频监控设备起着至关重要的作用。…
阅读更多...
wpf，工具栏上，最小化按钮的实现

wpf，工具栏上，最小化按钮的实现

工具栏上&#xff0c;最小化按钮的实现。工具栏做成的是用户控件。 用户控件的xaml <Button HorizontalAlignment"Right" Height"32" Click"MinimizeClick" /> 用户控件的cs代码 private void MinimizeClick(object sender, RoutedEven…
阅读更多...
2024年408真题计算机网络篇

2024年408真题计算机网络篇

1 https://zhuanlan.zhihu.com/p/721169467。最小割可以看作是切断水流的最薄弱环节——通过切断这些关键的“水管”&#xff0c;就可以完全阻止水从源点流到汇点。 在下列二进制数字调制方法中&#xff0c;需要2个不同频率载波 的是 A. ASK B. PSK C. FSK D. DPSK 解答…
阅读更多...
【行为树】02-基础的端口

【行为树】02-基础的端口

Input and Output Ports 输入和输出端口 正如我们之前解释的那样，自定义的TreeNodes可以用于执行任意简单或复杂的软件。它们的目标是提供一个具有更高抽象层级的接口。 因此，它们在概念上与函数没有不同。 类似于函数，我们经常想要： 将参数传递给一个节点(inputs)从一…
阅读更多...
论文Query2Label: A Simple Transformer Way to Multi-Label Classification

论文Query2Label: A Simple Transformer Way to Multi-Label Classification

本文将Transformer解码器用于多标签分类&#xff0c;将label embedding作为query&#xff0c;计算与feature map的cross-attention&#xff0c;取得了SOTA结果。 论文&#xff1a;https://arxiv.org/pdf/2107.10834.pdf 代码&#xff1a;https://github.com/SlongLiu/query2lab…
阅读更多...
洛谷-P3916 图的遍历

洛谷-P3916 图的遍历

题目描述 给出 N 个点&#xff0c;M 条边的有向图&#xff0c;对于每个点 v&#xff0c;求A(v) 表示从点 v 出发&#xff0c;能到达编号最大的点。 思路 既然是要找到最大的点&#xff0c;那么我从最大的点开始DFS是否可以&#xff1f; 于是可以反向建图&#xff0c;然后从最…
阅读更多...
Excel的基本应用 ___2

Excel的基本应用 ___2

快速插入函数 方法一&#xff1a; 方法二&#xff1a;快捷键 Alt&#xff1a;求和 动态查看 利用函数清单选择函数 相对地址和绝对地址的转换 FnF4
阅读更多...
寻觅义乌自闭症学校：了解寄宿制教育的选择

寻觅义乌自闭症学校：了解寄宿制教育的选择

在义乌乃至全国范围内&#xff0c;为自闭症儿童寻找一所合适的学校&#xff0c;是许多家庭面临的重大挑战。随着特殊教育的发展&#xff0c;越来越多的寄宿制学校以其独特的优势和全面的教育体系&#xff0c;为这些特殊的孩子提供了更加专业和细致的关怀。今天&#xff0c;我们…
阅读更多...
MySQL实战面试题(附案例答案+建表语句+模拟数据+案例深度解析)，练完直接碾压面试官

MySQL实战面试题(附案例答案+建表语句+模拟数据+案例深度解析)，练完直接碾压面试官

知识点思维导图 案例1 建表语句与模拟数据 用户表 users CREATE TABLE users ( id INT AUTO_INCREMENT PRIMARY KEY, username VARCHAR(50) NOT NULL, email VARCHAR(100) NOT NULL UNIQUE, signup_date DATE NOT NULL ); INSERT INTO users (username, email, signu…
阅读更多...
9月23日

9月23日

思维导图 作业 统计家目录下.c文件的个数 #!/bin/bashnum0for file in ~/*.c; doif [ -f "$file" ]; then((num))fi doneecho "家目录下.c文件的个数: $num"
阅读更多...
多个异构系统用户权限如何统一管理？

多个异构系统用户权限如何统一管理？

企业内部往往部署了多个业务系统来支撑不同的业务流程&#xff0c;然而&#xff0c;这些系统之间的标准不一&#xff0c;导致跨系统操作时权限不透明&#xff0c;难以确保数据安全与合规操作。同时&#xff0c;频繁的权限变更与维护工作量大且效率低&#xff0c;给企业带来了诸…
阅读更多...
基于单片机的智能窗帘控制系统-设计说明书

基于单片机的智能窗帘控制系统-设计说明书

设计摘要&#xff1a; 智能窗帘控制系统是一种利用单片机技术实现的智能化控制系统&#xff0c;可以实现窗帘的自动开合和定时控制功能。本系统的设计基于单片机技术&#xff0c;结合传感器、电机和执行器等硬件设备&#xff0c;实现对窗帘的智能化控制。通过传感器采集环境信…
阅读更多...
电动车车牌识别系统源码分享

电动车车牌识别系统源码分享

电动车车牌识别检测系统源码分享 [一条龙教学YOLOV8标注好的数据集一键训练_70全套改进创新点发刊_Web前端展示] 1.研究背景与意义 项目参考AAAI Association for the Advancement of Artificial Intelligence 项目来源AACV Association for the Advancement of Computer V…
阅读更多...
微服务架构的挑战与解决方案 —— Spring Cloud

微服务架构的挑战与解决方案 —— Spring Cloud

文章目录 微服务架构的挑战与解决方案 —— Spring Cloud挑战微服务挑战解决方案 - Spring Cloud什么是Spring CloudSpring Cloud 版本Spring Cloud实现方案Spring Cloud NetflixSpring Cloud Alibaba 微服务架构的挑战与解决方案 —— Spring Cloud 挑战 服务依赖复杂性 随着…
阅读更多...
Jetpack Compose 增强辅助工具(4)

Jetpack Compose 增强辅助工具(4)

导读大纲 1.1 探索 Compose 工具1.1.1 Compose Preview: 实时 UI 界面1.1.2 Interactive Mode: 测试UI行为1.1.3 其他实用功能 1.1 探索 Compose 工具 Android Studio 提供一套功能强大的工具 专门用于增强 Jetpack Compose 的开发体验 这些工具可以简化工作流程,提供实时反馈…
阅读更多...
最新文章

Copyright @ 2022~2023