1、QAbstractButton 属性
QAbstractButton 属性速查表 | |||
属性名 | 说明 | 属性名 | 说明 |
autoExclusive | 自动排他性 | checked | 是否被选中 |
autoRepeat | 是否启用自动重复 | down | 是否处于按下状态 |
autoRepeatDelay | 初始延迟(毫秒) | icon | 按钮上显示的图标 |
autoRepeatInterval | 时间间隔(毫秒 | iconSize | 显示的图标的大小 |
checkable | 是否可选中 | shortcut | 获取和设置快捷键 |
text | 获取和设置显示的文本 |
①、 autoExclusive: bool 访问函数:
bool autoExclusive() const;
void setAutoExclusive(bool);
描述了按钮的自动排他性,若启用了该属性,则属于同一父部件的可选中按钮的行为,
就好像是在同一排他性组中的按钮一样。除了单选按钮,默认为关闭。
②、 autoRepeat: bool 访问函数:
bool autoRepeat () const;
void setAutoRepeat(bool);
描述了按钮是否启用自动重复。当按钮处于按下状态(比如按下按钮不放)时,会以固
定间隔发送 pressed(), released(), clicked()信号。默认为关闭。 经测试,自动重复对
默认按钮无效,也就是按下 enter 键时,即使关闭自动重复,默认按钮仍会重复发送
上述信号。
③、 autoRepeatDelay: int 访问函数:
int autoRepeatDelay() const;
void setAutoRepeatDelay(int);
自动重复的初始延迟(毫秒)
④、 autoRepeatInterval: int 访问函数:
int autoRepeatInterval() const;
void setAutoRepeatInterval(int);
自动重复的时间间隔(毫秒)
⑤、 checkable: bool 访问函数:
bool isCheckable() const;
void setCheckable(bool);
按钮是否可选中,默认为可选中
⑥、 checked: bool 访问函数:
bool isChecked() const;
void setChecked(bool)
按钮是否被选中(即是否处于选中状态),只有可选中按钮才能被选中。默认未被选中。
⑦、 down: bool 访问函数:
bool isDown() const;
void setDown(bool);
按钮是否被按下(即是否处于按下状态)。若此属性为 true,则按钮被按下。 若把此属性
设置为 true,则不会发送 pressed()和 clicked()信号(经测试,仍会发送这些信号)。默认
为 false。
⑧、 icon: QIcon 访问函数:
QIcon icon() const;
void setIcon(const QIcon &);
按钮上显示的图标,
⑨、 iconSize: QSize 访问函数:
QSize iconSize() const;
void setIconSize(const QSize);
按钮上显示的图标的大小。默认大小由 GUI 样式定义。这是图标的最大大小,较小
的图标不会被放大。
⑩、 shortcut : QKeySequence
访问函数:
QKeySequence shortcut() const;
void setShortcut(const QKeySequence&);
保存与按钮关联的助记符, QKeySequence 类型见后文
⑪、 text: QString 访问函数:
QString text() const;
void setText(const QString&);
按钮上显示的文本。若按钮没有文本,则 text()返回一个空字符串。
示例 1:按钮的排他性与自动重复
//m.h 文件的内容
#ifndef M_H
#define M_H
#include<QtWidgets>
#include <iostream>
using namespace std;
class B : public QPushButton
{ Q_OBJECTpublic: B(QString s="",QWidget *p=0):QPushButton(s,p){}//若重写以下事件处理函数,则使用该类创建的按钮,将不会发送 Qt 内置的信号(比如 clicked()等)//void mousePressEvent(QMouseEvent *e){cout<<"D"<<endl;}public slots: //注: qt5.0 之后,可使用普通函数作为槽函数。void f(){ cout<<"F"<<endl; }
};
#endif//m.cpp 文件的内容
#include "m.h"
int main(int argc, char *argv[]){QApplication a(argc,argv);//创建部件QWidget w; B *pb1=new B("AAA",&w); B *pb11=new B("AAA1",&w);QCheckBox *pb2=new QCheckBox("BBB",&w); QCheckBox *pb3=new QCheckBox("CCC",&w);QCheckBox *pb4=new QCheckBox("DDD",&w); QRadioButton *pb5=new QRadioButton("EEE",&w);QRadioButton *pb6=new QRadioButton("FFF",&w); //单选按钮默认具有排他性。QCheckBox *pb7=new QCheckBox("GGG",&w);//布局各部件pb1->move(22,22); pb11->move(99,22);pb2->move(22,77); pb3->move(99,77); pb4->move(155,77);pb5->move(22,122); pb6->move(99,122); pb7->move(155,122);pb1->setAutoRepeat(true); //pb1 开启自动重复pb1->setAutoRepeatDelay(1000); //设置初始延迟为 1 秒pb1->setAutoRepeatInterval(2000); //设置时间间隔为 2 秒//把按钮 pb1 的 clicked 信号与槽 f 关联。QObject::connect(pb1,&QPushButton::released,pb1,&B::f);pb2->setAutoExclusive(true); pb3->setAutoExclusive(true); //开启按钮的排他性pb11->setDown(true); //设置为按下状态pb7->setCheckable(false); //设置为不可选中。w.resize(300,200); w.show(); return a.exec();
}
结果:
二、QAbstractButton 类中的成员函数
①、 QAbstractButton(QWidget *parent=Q_NULLPTR); //构造函数
②、 QButtonGroup* group() const //该函数见后文。
返回此按钮所属的组,若按钮不是任何 QButtonGroup 的成员,则返回 0。
三、QAbstractButton 类中的信号
①、 void clicked(bool checked =false);
以下情形会发送此信号
鼠标点击按钮然后释放时,注意:按钮释放时才会发送。
调用 click()或 animateClick()函数时。
按下对应的快捷键或空格键时。
当调用 setDown()、 setChecked()或 toggle()函数时,不会发送该信号。
若按钮是可选中的, 当按钮被选中时, 参数 checked 为 true,若按钮未被选中,
则为 false。
需要注意的是 QWidget 类并不发送此信号及 pressed 和 released 信号。
②、 void pressed(); 按下按钮时发送此信号
③、 void released(); 释放按钮时发送此信号。
④、 void toggled(bool checked);
每当可选中按钮切换状态时,都会发送此信号。若按钮被选中,则参数 checked
为 true,若按钮被取消选中,则为 false。
按钮状态的改变可能是由于用户操作, click()槽函数或 setChecked()函数被调用的
结果。
在发出信号前,将更新排他性按钮组中按钮的状态
四、QAbstractButton 类中的槽
①、 void animateClick(int m=100);
执行动画单击:即,立即按下按钮,然后在 m 毫秒之后释放。在释放按钮之前再次调
用此函数,会重新设置计时器。所有与单击有关的信号都会根据情况发出。若该按钮
被禁用,则此功能不起作用。
②、 void click()
此槽接收来自与点击相关的常见信号,若按钮是可选中的,则切换该按钮的状态。若
该按钮被禁用,则此槽函数不起作用。
③、 void toggle(); 切换可选中按钮的状态。
示例 2:动画点击与状态切换
//m.h 文件的内容。
#ifndef M_H
#define M_H
#include <QtWidgets>
#include <iostream>
using namespace std;
class B:public QPushButton{ Q_OBJECTpublic: B(QString s="",QWidget *p=0):QPushButton(s,p){}public slots: //注: qt5.0 之后,可使用普通函数作为槽函数。void f(){ cout<<"F"<<endl; }void g(){ animateClick(4000); }//执行动画点击,即按下按钮 4 秒之后,按钮才会被弹起
};
#endif//m.cpp 文件的内容
#include "m.h"
int main(int argc, char *argv[]){QApplication a(argc,argv);//创建部件QWidget w; B *pb1=new B("AAA",&w); B *pb11=new B("AAA1",&w);QCheckBox *pb2=new QCheckBox("BBB",&w);//布局各部件pb1->move(22,22); pb11->move(99,22); pb2->move(22,77);//把各按钮与相应的槽关联。QObject::connect(pb1,&QPushButton::clicked,pb2,&QCheckBox::toggle);QObject::connect(pb2,&QCheckBox::toggled,pb1,&B::f);QObject::connect(pb11,&QPushButton::pressed,pb1,&B::g);w.resize(300,200); w.show(); return a.exec();
}
结果: