当前位置：首页 > news >正文

Qt常用控件之按钮类控件

news 来源：原创 2025/7/18 16:21:46

QPushButton

添加图标

添加快捷键

QRadioButton

关于toggled

模拟点餐功能

QCheckBox

刚刚 QWidget 中涉及到的各种属性/函数/使用方法，针对接下来要介绍的 Qt 的各种控件都是有效的，因为各种控件都是继承自 QWidget 的

接下来本篇博客就学习 Qt 中提供的常用的按钮类控件

QPushButton

使用 QPushButton 表示一个按钮，这也是当前我们最熟悉的一个控件了
我们在前面经常使用pushButton，设置按钮的文本，还使用按钮的点击信号(clicked)，并把这个点击信号绑定在槽函数上，于是就会在点击按钮的时候，触发对应的函数调用

QPushButton 继承自 QAbstractButton，这个类是一个抽象类，是其他按钮的父类

抽象类
这个类包含了纯虚函数，无法创建出实例(对象)，就得创建子类，重写上述的纯虚函数，才能够创建出子类的实例

继承关系如下所示：

下面看 QAbstractButton 中,和 QPushButton 相关性较大的属性：

属性	说明
text	按钮中的文本
icon	按钮中的图标
iconSize	按钮中图标的尺寸
shortCut	按钮对应的快捷键
autoRepeat	按钮是否会重复触发，当鼠标左键按住不放时：如果设为 true，则会持续产生鼠标点击事件; 如果设为 false，则必须释放鼠标，再次按下鼠标时才能产生点击事件 (相当于游戏手柄上的"连发"效果)
autoRepeatDelay	重复触发的延时时间，按住按钮多久之后，开始重复触发
autoRepeatInterval	重复触发的周期

添加图标

这里说一句，在我们后续编写代码时，如果用到一些图片等外部资源，都会优先考虑 qrc，除非这个资源太大了

下面创建一个新的qrc文件(前面已经做过类似的操作)：
先点新建文件，选择 Qt - Resource，点 Add Prefix 创建前缀，再点 Add Files，此时将图片拷贝到弹出的路径即可，最终结果为下图所示：

接下来通过图形化的方式，创建一个按钮：

下面在构造函数中，进行代码的编写：

需要注意：
setIconSize 这个函数中，参数是 QSize，所以需要创建一个 QSize 对象，或是像上图一样创建一个匿名对象，作为参数传入

运行程序：

可以看到我们传入的图片已经被添加为按钮图标了

添加快捷键

前面写过一个例子，通过四个按钮，控制 target 按钮的移动
之前这个移动是通过鼠标点击按钮来实现的
此处就可以引入快捷键，通过快捷键来操作，此处按钮直接通过图片来表示

接下来继续创建一个新的qrc文件，在当前路径下创建一个文件夹，再将刚刚图标的 dog.png 和四个箭头图片都放进去：

把图片导入项目的时候，由于图片多了，不想再继续放到项目根目录下了，就创建了 image 目录,把图片放到 image 目录中，此时意味着后续访问这些图片，就需要再路径中带上 image 这一级目录名字

下面编辑 ui 界面，按钮上面没有编辑文本，因为等会会添加图标：

此时 Qt Designer 的右上角如下：
这也就是 Qt 程序运行过程中，对象树的模样，可以更直观的看到对象结构，以及每个对象的 objectName

下面编写构造函数，完成初始化操作：

此时运行程序，效果如下：

实现方向键的槽函数：

此时运行程序后，点击上下左右，target按钮也会上下左右移动，没有问题

下面设置快捷键，也是需要在 Widget 的构造函数中完成，程序一启动，快捷键就是有效的：

setShortcut函数的参数是 QKeySequence：

此时就可以按键盘上的 WSAD，控制 target按钮的上下左右移动啦

这是直接通过按键的名字来设置，虽然简单，但是容易写错
还可以通过按键的枚举来设置快捷键：

上述第二种方式是比较推荐的，因为可以自己选择，如果按键拼写错误会报错
而上面第一种靠自己手输按键，可能会出现按键拼写错误的情况，而且还不报错

上述的设置快捷键只设置了一个键，我们也可以设置组合键：
两种方式是一样的

关于连发功能

键盘快捷键，默认就是能连发的
例如：长按D，就能够一直向右移动

但是鼠标点击按钮则不行，想要鼠标也支持连发，就需要设置 autoReapeat 属性了：

到此 pushButton 添加快捷键的知识就讲述完毕了

QRadioButton

QRadioButton 是单选按钮，可以让我们在多个选项中选择一个

QAbstractButton 中和 QRadioButton 关系较大的属性：

属性	说明
checkable	是否能选中
checked	是否已经被选中，checkable是checked的前提条件
autoExclusive	是否排他选中一个按钮之后是否会取消其他按钮的选中因为是单选按钮，所以对于 QRadioButton 来说默认就是排他的

下面以图形化的方式创建三个 RadioButton：