【Qt】按钮的属性&相关API

目录

一. QPushButton

二. QRadioButton

按钮组

三. QCheckBox


Qt中按钮的继承体系如下图

QAbstractButton是一个抽象类,集成了按钮的核心属性和API

按钮说明
QPushButton(普通按钮)最常见的按钮,用于触发操作或者事件。可以设置文本、图标等属性,并且可以响应点击事件
QCheckBox(复选框)允许用户从多个选项中选择一个或多个选项。每个复选框都可以独立选择或取消选择
QRadioButton(单旋按钮)用于在一组选项中选择一个选项。
QToolButton(工具按钮)与QPushButton类似,但通常用于工具栏或者工具箱中,可以设置文本、图标等属性,也可以作为单选按钮或复选按钮使用

实际开发中,前三种按钮比较常使用,QToolButton的使用较少,其功能和QPushButton有较多重合 

一. QPushButton

因为四种按钮都继承自QAbstractButton,所以都可以使用其属性,其中和QPushButton相关性较大的属性如下:

属性说明
text按钮中的文本
icon按钮中的图标
iconSize按钮中图标的大小
shortCut按钮对应的快捷键
autoRepeat鼠标持续按下时,按钮是否会重复触发。true则会持续产生鼠标点击事件,false反之
autoRepeatDelay重复触发的延时时间。鼠标持续按下多久后,开始重复触发
autoRepeatInterval 重复触发的周期。鼠标持续按下后,两次鼠标触发事件的间隔时间

相关API 

Qt的API设计风格非常清晰,此处列出的属性都是可以获取设置的。

例如使用text()获取按钮文本;使用setText()设置按钮文本

示例:创建4个带图标的按钮控制目标按钮的上下左右移动,并且关联快捷键

(1). 通过Qt Designer添加按钮并设置其objectName

(2). 设置按钮图标  —— 使用qrc文件  参看博客  ..............................................................................

   qrc文件结构如图

(3). 设置图标     按钮的属性等都在Widget构造函数中设置


 
 
  1. #include "widget.h"
  2. #include "ui_widget.h"
  3. Widget:: Widget(QWidget *parent)
  4. : QWidget(parent)
  5. , ui( new Ui::Widget)
  6. {
  7. ui-> setupUi( this);
  8. //设置目标按钮的图标
  9. ui->pushButton_target-> setIcon( QIcon( ":/image/cat.png"));
  10. ui->pushButton_target-> setIconSize( QSize( 80, 80));
  11. //设置控制按钮的图标
  12. ui->pushButton_up-> setIcon( QIcon( ":/image/up.png"));
  13. ui->pushButton_up-> setIconSize( QSize( 50, 50));
  14. ui->pushButton_down-> setIcon( QIcon( ":/image/down.png"));
  15. ui->pushButton_down-> setIconSize( QSize( 50, 50));
  16. ui->pushButton_left-> setIcon( QIcon( ":/image/left.png"));
  17. ui->pushButton_left-> setIconSize( QSize( 50, 50));
  18. ui->pushButton_right-> setIcon( QIcon( ":/image/right.png"));
  19. ui->pushButton_right-> setIconSize( QSize( 50, 50));
  20. }
  21. Widget::~ Widget()
  22. {
  23. delete ui;
  24. }

 (4). 关联信号与槽函数


 
 
  1. void Widget::on_pushButton_up_clicked()
  2. {
  3. //获取目标按钮的位置
  4. QRect rect = ui->pushButton_target-> geometry();
  5. //向上移动5个像素
  6. ui->pushButton_target-> setGeometry(rect. x(), rect. y() - 5, rect. width(), rect. height());
  7. }
  8. void Widget::on_pushButton_down_clicked()
  9. {
  10. //获取目标按钮的位置
  11. QRect rect = ui->pushButton_target-> geometry();
  12. //向下移动5个像素
  13. ui->pushButton_target-> setGeometry(rect. x(), rect. y() + 5, rect. width(), rect. height());
  14. }
  15. void Widget::on_pushButton_left_clicked()
  16. {
  17. //获取目标按钮的位置
  18. QRect rect = ui->pushButton_target-> geometry();
  19. //向左移动5个像素
  20. ui->pushButton_target-> setGeometry(rect. x() - 5, rect. y(), rect. width(), rect. height());
  21. }
  22. void Widget::on_pushButton_right_clicked()
  23. {
  24. //获取目标按钮的位置
  25. QRect rect = ui->pushButton_target-> geometry();
  26. //向右移动5个像素
  27. ui->pushButton_target-> setGeometry(rect. x() + 5, rect. y(), rect. width(), rect. height());
  28. }

(5). 设置快捷键

快捷键有两种设置方式:

1. 传参使用QKeySequence


 
 
  1. //设置快捷键
  2. //ui->pushButton_up->setShortcut(QKeySequence("ctrl + w"));
  3. ui->pushButton_up-> setShortcut( QKeySequence( "w"));
  4. ui->pushButton_down-> setShortcut( QKeySequence( "s"));
  5. ui->pushButton_left-> setShortcut( QKeySequence( "a"));
  6. ui->pushButton_right-> setShortcut( QKeySequence( "d"));

直接通过字符串指明,复合快捷键也是直接指明,如"ctrl + w

2. 传参使用Qt内置的枚举类型


 
 
  1. //另一种设置方法
  2. //ui->pushButton_up->setShortcut(Qt::CTRL + Qt::Key_W);
  3. ui->pushButton_up-> setShortcut(Qt::Key_W);
  4. ui->pushButton_up-> setShortcut(Qt::Key_S);
  5. ui->pushButton_up-> setShortcut(Qt::Key_A);
  6. ui->pushButton_up-> setShortcut(Qt::Key_D);

复合快捷键也是直接指明,如Qt::CTRL + Qt::Key_W

6. 设置连点。

如果使用快捷键,持续按下快捷键,会有连点的效果,这是键盘自带的

autoRepeat属性是鼠标点击按钮的连点效果


 
 
  1. //设置鼠标连点
  2. ui->pushButton_up-> setAutoRepeat( true);
  3. ui->pushButton_down-> setAutoRepeat( true);
  4. ui->pushButton_left-> setAutoRepeat( true);
  5. ui->pushButton_right-> setAutoRepeat( true);

二. QRadioButton

QRadioButton是单旋按钮,可以让我们在多个选项中选择一个,具有排他性

 核心属性

属性说明
checkable是否能被选中,true代表可以
checked是否已经被选中,checkable是checked的前提
autoExclusive

是否排他

选中一个按钮后是否会取消其他按钮的选中

QRadioButton默认排他,即autoExclusive为true

 相关API

API说明
setCheckAble(bool)设置是否可选。若设置为false,不可选,但点击依然可以触发点击事件
setEnabled(bool)继承自QWidget的API,设置控件是否可用
setChecked(bool)

设置按钮是否已经被选中,不会触发普通点击事件

QAbstractButton提供了5种信号

信号说明
clicked()普通点击事件,不带参数
clicked(bool)普通点击事件,参数为一个bool值,表示该按钮是否被选中
pressed()鼠标按下
released()鼠标松开
toggled(bool)bool值表示该按钮是否被选中,当该状态改变时,该事件触发

按钮组

因为单选按钮是排他的,但我们期望实现,每一组内部控制排他,但是组之间不排他。

默认当前界面的所有按钮都排他,再选中另一个都会取消前一个的选中状态。为此我们需要对按钮进行分组——QButtonGroup

QButtonGroup的创建需要添加到对象树中

添加按钮分组的函数为addButton()


 
 
  1. QButtonGroup *g1 = new QButtonGroup( this);
  2. g1-> addButton(ui->radioButton);
  3. g1-> addButton(ui->radioButton_2);
  4. g1-> addButton(ui->radioButton_3);
  5. QButtonGroup *g2 = new QButtonGroup( this);
  6. g2-> addButton(ui->radioButton_4);
  7. g2-> addButton(ui->radioButton_5);
  8. g2-> addButton(ui->radioButton_6);
  9. QButtonGroup *g3 = new QButtonGroup( this);
  10. g3-> addButton(ui->radioButton_7);
  11. g3-> addButton(ui->radioButton_8);
  12. g3-> addButton(ui->radioButton_9);

 相同组的按钮排他,组之间无排他效果

三. QCheckBox

QCheckBox表示复选按钮,可以允许选中多个,没有排他性

QcheckBox有一个独有属性——tristate,用于实现“三态复选框” 

tristate属性表示复选框是三种状态还是两种状态,如果tristate为True,表示复选框有选中,未选中,和半选中三种状态;如果tristate为False,则表示复选框只有选中和未选中两种状态

相关API

API说明
setTriState(bool)设置复选框是否为三态复选框
setCheckState(Qt::CheckState)设置三态复选框的状态,具体设置见下表

三态复选框的三种状态

名称含义
Qt.Checked2组件被选中(默认)
Qt.PartiallyChecked1组件被半选中
Qt.Unchecked0组件未选中

注意:CheckState=1或2时,isChecked()的返回值都是True 

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值