Qt常用控件:按钮类控件,普通按键、单选、复选

目录

[1. PushButton](#1. PushButton)

[代码示例: 带有图标的按钮](#代码示例: 带有图标的按钮)

[代码示例: 带有快捷键的按钮](#代码示例: 带有快捷键的按钮)

[代码示例: 按钮的重复触发](#代码示例: 按钮的重复触发)

[2. Radio Button](#2. Radio Button)

[代码示例: 选择性别](#代码示例: 选择性别)

设置默认选项

禁用选中

禁用按钮

[代码示例: click, press, release, toggled 的区别](#代码示例: click, press, release, toggled 的区别)

[代码示例: 单选框分组(点餐)](#代码示例: 单选框分组(点餐))

[4. Check Box](#4. Check Box)

[代码示例: 获取复选按钮的取值](#代码示例: 获取复选按钮的取值)

[5. Tool Button](#5. Tool Button)


1. Push Button

使用 QPushButton 表示一个按钮。这也是当前我们最熟悉的一个控件了。

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

在 Qt Designer 中也能够看到这里的继承关系

QAbstractButton 中,和 QPushButton 相关性较大的属性

属性 说明
text 按钮中的文本
icon 按钮中的图标
iconSize 按钮中图标的尺寸
shortCut 按钮对应的快捷键
autoRepeat 按钮是否会重复触发。当鼠标左键按住不放时,如果设为 true,则会持续产生鼠标点击事件;如果设为 false,则必须释放鼠标,再次按下鼠标时才能产生点击事件。(相当于游戏手柄上的"连发"效果)
autoRepeatDelay 重复触发的延时时间。按住按钮多久之后,开始重复触发。
autoRepeatInterval 重复触发的周期。
  1. QAbstractButton 作为 QWidget 的子类,当然也继承了 QWidget 的属性。上面 介绍的 QWidget 里的各种属性用法,对于 QAbstractButton 同样适用。因此表格仅 列出 QAbstractButton 独有的属性。
  2. Qt 的 api 设计风格是非常清晰的。此处列出的属性都是可以 获取 和 设置 的。例如,使 用 text() 获取按钮文本;使用 setText() 设置文本。

事实上,QPushButton 的核心功能都是 QAbstractButton 提供的。自身提供的属性都比较简单。

其中 default 和 audoDefault 影响的是按下 enter 时自动点击哪个按钮的行为;flat 把按设置为扁平的样式。这里我们暂时都不做过多关注。

代码示例: 带有图标的按钮

  • 创建 resource.qrc 文件,并导入图片
  • 修改 widget.cpp,给按钮设置图标
cpp 复制代码
Widget::Widget(QWidget *parent)
 : QWidget(parent)
 , ui(new Ui::Widget)
{
     ui->setupUi(this);
     // 创建图标 
     QIcon icon(":/doge.png");
     // 设置图标 
     ui->pushButton->setIcon(icon);
     // 设置图标⼤⼩ 
     ui->pushButton->setIconSize(QSize(50, 50));
}

代码示例: 带有快捷键的按钮

  • 在界面中拖五个按钮。
  • 五个按钮的 objectName 分别为 pushButton_target , pushButton_up , pushButton_down , pushButton_left , pushButton_right
  • 五个按钮的初始位置随意,其中 pushButton_target 尺寸设置为 100 * 100,其余按钮设为 50 * 50。文本内容均清空

修改 widget.cpp,设置图标资源和快捷键。

  • 使用 setShortcut 给按钮设置快捷键,参数是一个 QKeySequence 对象。表示一个按键序列。支持组合键(ctrl + c 这种)。
  • QKeySequence 的构造函数参数,可以直接使用 "ctrl+c" 这样的按键名字符串表示,也可以使用预定义好的常量(形如 Qt::CTRL + Qt::Key_C )表示。
cpp 复制代码
Widget::Widget(QWidget *parent)
 : QWidget(parent)
 , ui(new Ui::Widget)
{
     ui->setupUi(this);
     // 设置图标 
     ui->pushButton_target->setIcon(QIcon(":/dog.png"));
     ui->pushButton_target->setIconSize(QSize(100, 100));
     ui->pushButton_up->setIcon(QIcon(":/caret-up.png"));
     ui->pushButton_down->setIcon(QIcon(":/caret-down.png"));
     ui->pushButton_left->setIcon(QIcon(":/caret-left.png"));
     ui->pushButton_right->setIcon(QIcon(":/caret-right.png"));
     // 设置快捷键 
     ui->pushButton_up->setShortcut(QKeySequence("w"));
     ui->pushButton_down->setShortcut(QKeySequence("s"));
     ui->pushButton_left->setShortcut(QKeySequence("a"));
     ui->pushButton_right->setShortcut(QKeySequence("d"));
 
     // 设置快捷键也可以写作 
     // ui->pushButton_up->setShortcut(QKeySequence(Qt::Key_W));
     // ui->pushButton_down->setShortcut(QKeySequence(Qt::Key_S));
     // ui->pushButton_left->setShortcut(QKeySequence(Qt::Key_A));
     // ui->pushButton_right->setShortcut(QKeySequence(Qt::Key_D));
}

修改 widget.cpp,设置四个方向键的 slot 函数。

cpp 复制代码
void Widget::on_pushButton_up_clicked()
{
     const QRect& rect = ui->pushButton_target->geometry();
     ui->pushButton_target->setGeometry(rect.x(), rect.y() - 5, rect.width(), 
rect.height());
     qDebug() << "up";
}

void Widget::on_pushButton_down_clicked()
{
     const QRect& rect = ui->pushButton_target->geometry();
     ui->pushButton_target->setGeometry(rect.x(), rect.y() + 5, rect.width(), 
rect.height());
     qDebug() << "down";
}

void Widget::on_pushButton_left_clicked()
{
     const QRect& rect = ui->pushButton_target->geometry();
     ui->pushButton_target->setGeometry(rect.x() - 5, rect.y(), rect.width(), 
rect.height());
     qDebug() << "left";
}

void Widget::on_pushButton_right_clicked()
{
     const QRect& rect = ui->pushButton_target->geometry();
     ui->pushButton_target->setGeometry(rect.x() + 5, rect.y(), rect.width(), 
rect.height());
     qDebug() << "right";
}

运行程序,此时点击按钮,或者使用 wasd 均可让狗头移动。

代码示例: 按钮的重复触发

  • 在上述案例中,按住快捷键,是可以进行重复触发的,但是鼠标点击则不能。
  • 修改 widget.cpp,在构造函数中开启重复触发。
  • 此时,按住鼠标时,即可让狗头连续移动。
cpp 复制代码
// 开启重复触发 
ui->pushButton_up->setAutoRepeat(true);
ui->pushButton_down->setAutoRepeat(true);
ui->pushButton_left->setAutoRepeat(true);
ui->pushButton_right->setAutoRepeat(true);

2. Radio Button(单选)

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

作为 QAbstractButton 和 QWidget 的子类,上面介绍的属性和用法,对于 QRadioButton 同样适用。

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

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

代码示例: 选择性别

  • 在界面上创建一个 label,和 3 个单选按钮
  • 设置的文本如下图
  • 3 个单选按钮的 objectName 分别为 radioButton_male , radioButton_female , radioButton_other
cpp 复制代码
void Widget::on_radioButton_male_clicked()
{
     ui->label->setText("你选择的性别为: 男");
}

void Widget::on_radioButton_female_clicked()
{
     ui->label->setText("你选择的性别为: ⼥");
}

void Widget::on_radioButton_other_clicked()
{
     ui->label->setText("你选择的性别为: 其他");
}

运行程序,可以看到随着选择不同的单选按钮,label 中的提示文字就会随之变化。

设置默认选项

  • 当前代码中,如果程序启动,则不会选择任何选项。
  • 可以修改代码,让程序启动默认选中性别男
cpp 复制代码
Widget::Widget(QWidget *parent)
 : QWidget(parent)
 , ui(new Ui::Widget)
{
     ui->setupUi(this);
     // 设置默认选中该按钮 
     ui->radioButton_male->setChecked(true);
     ui->label->setText("你选择的性别为: 男");
}

禁用选中

  • 当前代码中,也可以禁用 "其他" 被选中(但还是会发射信号)
  • 修改 widget.cpp 的构造函数
cpp 复制代码
// 禁⽤ other 选项 
ui->radioButton_other->setCheckable(false);

运行程序,可以看到,点击 "其他" 按钮的时候,虽然不会被选中,但是可以触发点击事件,使上面的 label 显示性别为其他

禁用按钮

使用 setEnabled 是更彻底的禁用按钮的方式。此时该按钮无法被选中,也无法响应任何输入

cpp 复制代码
// 禁⽤ other 选项 
ui->radioButton_other->setEnabled(false);

代码示例: click, press, release, toggled 的区别

  • clicked 表示一次 "点击"
  • pressed 表示鼠标 "按下"
  • released 表示鼠标 "释放"
  • toggled 表示按钮状态切换。
  1. 在界面上创建四个单选按钮
  2. objectName 分别为 radioButton , radioButton_2 , radioButton_3 , radioButton_4
  • 给 1 创建 clicked 槽函数
  • 给 2 创建 pressed 槽函数
  • 给 3 创建 released 槽函数
  • 给 4 创建 toggled 槽函数

运行程序,可以看到

  • clicked 是一次鼠标按下+鼠标释放触发的。
  • pressed 是鼠标按下触发的。
  • released 是鼠标释放触发的。
  • toggled 是 checked 属性改变时触发的。

总的来说,toggled 是最适合 QRadioButton 的。

cpp 复制代码
void Widget::on_radioButton_clicked()
{
     qDebug() << "clicked";
}

void Widget::on_radioButton_2_pressed()
{
     qDebug() << "pressed";
}

void Widget::on_radioButton_3_released()
{
     qDebug() << "released";
}

void Widget::on_radioButton_4_toggled(bool checked)
{
     if (checked) {
     qDebug() << "toggled checked true";
     } 
     else {
     qDebug() << "toggled checked false";
     }
}

代码示例: 单选框分组(点餐)

  • 在界面上创建 6 个单选框,用来模拟麦当劳点餐界面。
  • objectName 分别为 radioButton 到 radioButton_6
  • 此时直接运行程序,可以看到,这六个 QRadioButton 之间都是排他的

  • 汉堡、小食、饮料不能额各自选一个,选择下一个会自动取消上一个

  • 我们希望每一组内部来控制排他,但是组和组之间不能排他

  • 引入 QButtonGroup 进行分组

  • 排他性只在各自分组内有效

修改 widget.cpp

cpp 复制代码
Widget::Widget(QWidget *parent)
 : QWidget(parent)
 , ui(new Ui::Widget)
{
     ui->setupUi(this);
     // 创建三个 QButtonGroup 
     QButtonGroup* group1 = new QButtonGroup(this);
     QButtonGroup* group2 = new QButtonGroup(this);
     QButtonGroup* group3 = new QButtonGroup(this);
     // 把 QRadioButton 两两⼀组, 放到三个 QButtonGroup 中.  
     group1->addButton(ui->radioButton);
     group1->addButton(ui->radioButton_2);
     group2->addButton(ui->radioButton_3);
     group2->addButton(ui->radioButton_4);
     group3->addButton(ui->radioButton_5);
     group3->addButton(ui->radioButton_6);
}

4. Check Box(复选)

QCheckBox 表示复选按钮。可以允许选中多个。

和 QCheckBox 最相关的属性也是 checkable 和 checked,都是继承自 QAbstractButton。

至于 QCheckBox 独有的属性 tristate 用来实现 "三态复选框"。这个东西比较冷门,咱们不做讨论。

代码示例: 获取复选按钮的取值

  • 在界面上创建三个复选按钮,和一个普通按钮。
  • objectName 分别为 checkBox_eat , checkBox_sleep , checkBox_play ,以及 pushButton
cpp 复制代码
void Widget::on_pushButton_clicked()
{
     QString result;
     if (ui->checkBox_eat->isChecked()) {
         result += ui->checkBox_eat->text();
     }

     if (ui->checkBox_sleep->isChecked()) {
         result += ui->checkBox_sleep->text();
     }

     if (ui->checkBox_play->isChecked()) {
         result += ui->checkBox_play->text();
     }

     qDebug() << "选中的内容: " << result;
}

5. Tool Button

QToolButton 的大部分功能,和 QPushButton 是一致的。但是 QToolButton 主要应用在工具栏,菜单等场景。这个我们暂时先不介绍。

相关推荐
屿华AI18 分钟前
AUTOSAR 实战-诊断工具 | 基于 Python 与 USB-CANFD 的 UDS 诊断测试工具设计与实现
开发语言·python·测试工具
SomeOtherTime43 分钟前
番外篇(第 12 讲):走向工业界深水区——从物理定律看 Rust 在真实工程中的“降维打击”与“阿喀琉斯之踵”
开发语言·rust
黑客笔记2 小时前
Python 进程池和线程池:用等待任务理解并发
开发语言·python
pps-key14 小时前
网络攻防入门:从“黑客梦”到合法实操(生存篇)
开发语言·web安全·php
汤姆宝库15 小时前
BPE分词器的完整实现:字节对合并与词表构建
开发语言·人工智能·c#
驭渊的小故事16 小时前
订单服务如何调用商品服务?一次 RestTemplate 跨服务调用入门
java·开发语言·php
Sakura_j_h_17 小时前
MCP SDK 2.0 实战:用 MCPServer 搭本地笔记检索服务
开发语言·笔记·python·qt·ai工具·mcp·mcpserver
微笑星河q17 小时前
C++STL【vector】常用接口函数使用和迭代器失效问题
开发语言·c++
Eider199818 小时前
Python基础语法之并发相关3
开发语言·python
FRing0318 小时前
vue2干货总结11(短信验证、登录功能、统一处理错误(响应拦截器)、将token信息存入vuex、vuex持久化处理)
开发语言·前端·javascript·vue.js·vue2