Qt框架核心组件完全指南:从按钮交互到定时器实现

发布于:2025-05-20 ⋅ 阅读:(16) ⋅ 点赞:(0)


前言

上一篇文章,我们已经探讨了Qlabe的使用,今天我们将继续进行c++版本Qt的讨论与学习。本篇文章会继续完成按钮类等基本类别的介绍和qt各种组件的学习。如果有任何问题,欢迎评论留言。如果发现文章有不妥和错误之处,欢迎各位小伙伴们在评论区指正,笔者会每一条评论和留言都会查看。


一、QAbstractButton 按钮类

概述

QAbstractButton是按钮控件的抽象基类,提供了按钮的基础特性和功能。

QAbstractButton
基类
QCheckBox
复选框
QRadioButton
单选按钮
QPushButton
按压式按钮
QToolButton
工具按钮

1.1 常用属性

  • text: 按钮显示的文本
  • icon: 按钮显示的图标(可从iconfont.cn获取非商用图标)
  • checkable: 按钮是否可选中
  • checked: 按钮是否被选中
  • down: 按钮是否被按下
    在这里插入图片描述

图标可以从下面的网站下载(非商用):

免费图标icons
阿里巴巴矢量图标库


1.2 常用信号

  • clicked(): 按钮被点击时发射
  • pressed(): 按钮被按下时发射
  • released(): 按钮被释放时发射
  • toggled(bool checked): 按钮选中状态改变时发射

22


1.3QButtonGroup 按钮组

用于管理多个按钮的互斥或多选逻辑。

创建按钮组

// 堆内存+手动创建
QButtonGroup::QButtonGroup(QObject * parent = 0)

添加按钮

// 参数1:要添加的按钮
// 参数2:组中的编号,非重复的正数
void QButtonGroup::addButton(QAbstractButton * button, int id = -1)

222
互斥性控制
默认情况下,exclusive属性为true,组内按钮互斥(如单选)。
若需支持多选,需显式设置为false:

group->setExclusive(false);  // 允许多选

示例代码包


二、QComboBox 组合框

在这里插入图片描述

提供下拉列表供用户选择,功能类似 QRadioButton(单选),但占用更少的界面空间,适合选项较多或需要紧凑布局的场景。

常用属性
在这里插入图片描述
常用信号
在这里插入图片描述
示例代码包


三、若干与数字相关的组件

在这里插入图片描述

共有属性
minimum (int)

说明:组件允许的最小值
类型:整数
maximum (int)

说明:组件允许的最大值
类型:整数
value (int)

说明:组件的当前值(必须在 minimum 和 maximum 范围内)
类型:整数

共有信号
valueChanged(int i)
触发条件:当组件的 value 值发生变化时发射。
参数:i 表示变化后的新值。

// value值变化时发射的信号
void	valueChanged(int i)            [signal]

代码示例:
当拖动QDial组件的时候,其它进度条会一起变动
示例包


四、QString 字符串类

基本特性
Qt框架中的字符串类,采用Unicode编码
每个字符用16位的QChar表示,支持多语言字符(如中文、日文等)
高度兼容标准C++的字符串API

英文名称 中文解释
append 向后追加
at 取出元素
begin 获取开始位置的迭代器
clear 清空
compare 比较
contains 包含
count 数量
endsWith 以…结尾
fill 每个元素填充
indexOf 出现的位置序号
insert 插入
isEmpty/isNull 是否为空,注意二者有差别
lastIndexOf 最后一次出现的位置下标
length 长度
prepend 向前追加
push_back 向后追加
push_front 向前追加
remove 移除
replace 替换
size 大小
split 分割
startsWith 以…开始
swap 交换
trimmed 去除空格
truncate 截取

核心功能

// 数字 → QString
// 参数1:要转换的数字
// 参数2:进制(默认10进制)
// 返回值:转换后的字符串
QString QString::number(long n, int base = 10) [static]
// QString → int
// 参数1:bool指针接收转换成功状态(可选)
// 参数2:进制(默认10进制)
// 返回值:转换后的数字(失败返回0)
int QString::toInt(bool *ok = nullptr, int base = 10) const

代码示例解析

#include "dialog.h"
#include "ui_dialog.h"
#include <QDebug>  // 添加调试输出头文件

Dialog::Dialog(QWidget *parent) :
    QDialog(parent),
    ui(new Ui::Dialog)
{
    ui->setupUi(this);

    // 示例1:多语言字符处理
    QString text = "あいうえお你好";  // 混合日文和中文
    qDebug() << "字符数量:" << text.count();  // 输出:7(每个字符占1个计数)

    // 示例2:数字转字符串(3进制)
    int count = 23;
    text = QString::number(count, 3);  // 23的三进制表示
    qDebug() << "三进制字符串:" << text;  // 输出:"212"

    // 示例3:字符串转数字(带错误检查)
    text = "0";
    bool convertSuccess = false;
    count = text.toInt(&convertSuccess, 10);  // 十进制转换

    if(convertSuccess) {
        qDebug() << "转换成功:" << count;  // 输出:转换成功:0
    } else {
        qDebug() << "转换失败:" << count;  // 若text="abc",此处输出失败且count=0
    }
}

Dialog::~Dialog()
{
    delete ui;  // 清理UI资源
}

五、Qt容器类

Qt的容器类相比于C++的STL中的容器类更轻巧、安全和易于使用。

5.1 顺序容器 QList

示例: 使用QList存储自定义类Student

  1. 在Qt Creator中:
    • 右键项目 → “添加新文件”
    • 选择创建"C++类"
  2. 在弹出的窗口中:
    • 编写类名
  3. 项目管理界面:
    • 直接点击"完成"
  4. 编辑文件:
    • 在生成的头文件/源文件中编写类内容

Student + QList示例

代码包


5.2 关联容器 QMap

QMap示例
代码包


六、QVariant

QVariant 是 Qt 中用于通用类型存储和转换的类,能够封装 Qt 常见类型(如 int、QString、QList 等),并在需要时进行类型转换。其核心作用是提高函数的参数和返回值兼容性。

核心功能

  • 存储任意类型

  • 可保存 Qt 内置类型(如 QString、int、bool、QSize 等)及自定义类型(需通过 Q_DECLARE_METATYPE 注册)。
    类型安全转换

  • 提供 toXxx() 方法将存储的值转换为目标类型,若类型不匹配返回默认值(如 toInt() 失败返回 0)。
    运行时类型检查

  • 通过 type() 或 userType() 获取当前存储的实际类型(如 QVariant::String)。

基本用法

  1. Qt 类型 → QVariant
    直接通过构造函数或 setValue() 存储:
QVariant v1(42);            // 存储 int
QVariant v2("Hello");       // 存储 QString
QVariant v3 = QSize(100, 50); // 存储 QSize
  1. QVariant → Qt 类型
    调用 toXxx() 方法转换:
int num = v1.toInt();          // 42
QString text = v2.toString();  // "Hello"
QSize size = v3.toSize();      // QSize(100, 50)
  1. 类型检查与默认值
if (v1.canConvert<int>()) {
    int num = v1.toInt(); // 安全转换
}
QDate date = v4.toDate(QDate(2000, 1, 1)); // 转换失败返回默认值

七、跨平台数据类型

由于C++基础数据类型在不同平台/编译器下存在差异(如intlong等长度可能变化),Qt提供了以下跨平台类型保证一致性

7.1 基础数据类型

Qt 类型 等价C++类型 字节长度 说明
qint8 int8_t 1 有符号8位整数
quint8 uint8_t 1 无符号8位整数
qint16 int16_t 2 有符号16位整数
quint16 uint16_t 2 无符号16位整数
qint32 int32_t 4 有符号32位整数
quint32 uint32_t 4 无符号32位整数
qint64 int64_t 8 有符号64位整数
quint64 uint64_t 8 无符号64位整数
qreal double 8(*) 浮点数(多数平台为double)

*注:qreal 在多数平台是double(8字节),但在ARM架构可能为float(4字节)


7.2 特殊用途类型

Qt 类型 说明
qintptr 指针大小的有符号整数(内存地址)
quintptr 指针大小的无符号整数
qsizetype 大小相关的类型(如容器尺寸)
qfloat16 半精度浮点(Qt 6.0+)

7.3 字符类型

Qt 类型 等价C++类型 说明
QChar char16_t UTF-16字符(2字节)
char8_t C++20标准 UTF-8字符(Qt 6.0+支持)

八、QDateTime 日期时间类

Qt提供QDate处理日期、QTime处理时间,而QDateTime同时处理日期和时间。

8.1 常用函数

获取当前时间戳(毫秒)

qint64 QDateTime::currentMSecsSinceEpoch() [static]
返回从1970-01-01 00:00:00(UTC)到当前的毫秒数(时间戳)。

获取当前日期时间

QDateTime QDateTime::currentDateTime() [static]
返回包含当前系统日期和时间的QDateTime对象。

日期时间转字符串

QString QDateTime::toString(const QString &format) const

将QDateTime按指定格式转换为字符串,例如:

QDateTime now = QDateTime::currentDateTime();
QString str = now.toString("yyyy-MM-dd hh:mm:ss"); // 输出:2023-08-25 14:30:45

8.2 常用格式符

符号 含义 示例
yy 两位年份 23
yyyy 四位年份 2023
M 月份 (无前导零) 8
MM 月份(两位) 08
d 日(无前导零) 5
dd 日(两位) 05
h 小时(12小时制) 2
hh 小时(两位,12小时制) 02
H 小时(24小时制) 14
HH 小时(两位,24小时制) 14
m 分钟(无前导零) 3
mm 分钟(两位) 03
s 秒(无前导零) 5
ss 秒(两位) 05
AP AM/PM 标识 PM

8.3 相关组件

QDateEdit
在这里插入图片描述

用于编辑日期的输入框,支持日期选择器。
QTimeEdit
在这里插入图片描述

用于编辑时间的输入框,支持时间选择。
QDateTimeEdit
在这里插入图片描述

结合日期和时间的输入组件。
QCalendarWidget
在这里插入图片描述

提供图形化日历界面,用于选择日期。

8.4 代码示例

代码包(新版qt运行不了这个,要用老版本)


九、QTimer 定时器类

QTimer 是 Qt 提供的定时器类,用于处理周期性或一次性(延时)的任务。

9.1 主要属性

属性 类型 描述
active const bool 定时器是否在运行
interval int 间隔时间,单位毫秒
singleShot bool 是否是一次性定时器

9.2 常用函数

构造函数

QTimer::QTimer(QObject *parent = nullptr)

主要槽函数

// 启动定时器,如果定时器已经运行,则会停止并重新运行
void QTimer::start() [slot]
// 停止定时器
void QTimer::stop() [slot]

信号

// 定时器超时信号(到点了的通知信号)
void QTimer::timeout() [signal]

9.3 代码示例

代码包


总结

本文全面解析了Qt框架中的核心UI组件和功能类,首先介绍了QAbstractButton按钮基类及其子类(QPushButton、QCheckBox等)的属性和信号机制,详细说明了QButtonGroup的互斥控制实现;接着深入讲解了QComboBox下拉列表的紧凑布局优势,分析了数字组件(QSlider、QSpinBox等)的共有属性和联动逻辑;在数据处理部分,重点剖析了QString的多语言编码支持和类型转换方法,对比了QList顺序容器与QMap关联容器的使用场景;此外还详解了QVariant的通用类型存储机制、Qt跨平台数据类型的兼容性设计、QDateTime的日期时间处理技巧以及QTimer定时器的周期任务实现方案,通过多个代码示例包和可视化图表展示了各类组件的实际应用场景。


网站公告

今日签到

点亮在社区的每一天
去签到