一、按钮部件

按钮部件共同特性

Qt 用于描述按钮部件的类、继承关系、各按钮的名称和样式，如下图：

助记符：使用字符"&“可在为按钮指定文本标签时设置快捷键，在&之后的字符将作为快捷键。比如 “A&BC” 则 Alt+B 将成为该按钮的快捷键，使用”&"字符设置的快捷键常称为助记符，一般会在其对应字符下加上下划 线，对于 windows 当按下 Alt 键时，才会显示下划线。默认情况下 Qt 不会显示加下划线的快捷键。

按钮的排他性(或称为独占性)和排他性组(独点性组)：是指位于同一组(被称为排他性组)中的可选按钮，任何时候只能有一个按钮被选中，选中一个按钮会自动取消之前选中的按钮。Qt 使用 QButtonGroup 类描棕对按钮的分组，通常单选按钮具有排他性，当然复选按钮也可以具有排他性。

可选中、被选中、选中状态：可选中是指像复选按钮或单选按钮之类的按钮，他们是可以被选中的，被选中的按钮呈现出的状态就是选中状态。对于复选按钮，选中后在前面会有一个勾形的符号，而标准按钮 QPushButton 是不可被选中的。

按钮的按下和弹起状态：当在按钮上按下鼠标不放时，按钮通常看起来像是被按下的样子，这时的状态就是按下状态。

菜单按钮：是指单击该按钮会弹出一个下拉菜单的按钮，见下图， 在 Qt 中，标准按钮 QPushButton、工具按钮 QToolButton 可设置为菜单按钮。

按钮的启用与禁用：按钮被禁用时通常会变灰，按钮的启用/禁用是由 QWidget 类中的enabled 属性描述的。

抽象按钮类QAbstractButton

QAbstractButton类介绍

QAbstractButton 是个抽象类，该类是标准按钮 QPushButton、复选按钮 QCheckBox、单选按钮 QRadioButton、工具按钮 QToolButton 的父类，该类描述了按钮的一些共同功能，比如单击按钮发出的信号，按钮的状态等。注意：C++语法规定，不能创建抽象类的对象。

若要子类化 QAbstractButton 类，必须重新实现 paintEvent()函数(这是个纯虚函数)，以绘制按钮的轮廓或像素图，并且建议重新实现 sizeHint()，若有两个以上状态的按钮(如三态按钮)，还必须重新实现 checkStateSet()和 nextCheckState()函数。

注意：若重新实现了按钮类中的事件处理函数，有可能会阻止 Qt 对按钮的默认处理行为，比如若重写了 QCheckBox 类的 mousePressEvent()，则当在该按钮上单击鼠标时，不会使按钮被选中。因此，程序员重写这些事件处理函数时，通常需要调用父类的该函数，以便使用 Qt 的默认处理行为。

按下状态与选中状态

• Qt 在内置的默认事件处理函数 mousePressEvent()中(以鼠标点击为例)设置了按钮的按下状态，在 mouseReleaseEvent()中清除了按钮的按下状态。也就是说，若程序员仅仅重写了按钮的 mouseReleaseEvent() 函数，且在其中未清除按钮的按下状态，则当使用鼠标点击按钮后，按钮后一直处于按下状态。若重写了 mousePressEvent()函数，且未对按钮设置按下状态，则当用鼠标点击按钮时，则按钮不会出现按下状态。读者可自行编写程序进行验证。
• 按下状态与选中状态的默认执行顺序是：当用鼠标点击按钮时(使用其他方式点击按钮类似)，首先设置按下状态，然后设置选中状态，若再次用鼠标点击按钮，也是首先设置按下状态，然后再清除按钮的选中状态。在每次鼠标释放时会清除按钮的按下状态。

QAbstractButton 类中的属性函数

1）autoExclusive：bool 访问函数：bool autoExclusive() const; void setAutoExclusive(bool);
描述了按钮的自动排他性，若启用了该属性，则属于同一父部件的可选中按钮的行为，就好像是在同一排他性组中的按钮一样。除了单选按钮，默认为关闭。

2）autoRepeat：bool 访问函数：bool autoRepeat () const; void setAutoRepeat(bool);
描述了按钮是否启用自动重复。当按钮处于按下状态(比如按下按钮不放)时，会以固定间隔发送 pressed()，released()，clicked()信号。默认为关闭。经测试，自动重复对默认按钮无效，也就是按下 enter 键时，即使关闭自动重复，默认按钮仍会重复发送上述信号。

3）autoRepeatDelay：int 访问函数：int autoRepeatDelay() const; void setAutoRepeatDelay(int);
自动重复的初始延迟(毫秒)

4）autoRepeatInterval：int 访问函数：int autoRepeatInterval() const; void setAutoRepeatInterval(int);
自动重复的时间间隔(毫秒)

5）checkable：bool 访问函数：bool isCheckable() const; void setCheckable(bool);
按钮是否可选中，默认为可选中

6）checked：bool 访问函数：bool isChecked()const; void setChecked(bool)
按钮是否被选中(即是否处于选中状态)，只有可选中按钮才能被选中。默认未被选中。

7）down：bool 访问函数：bool isDown()const;void setDown(bool);
按钮是否被按下(即是否处于按下状态)。若此属性为 true，则按钮被按下。若把此属性设置为 true，则不会发送 pressed()和 clicked()信号(经测试，仍会发送这些信号)。默认为 false。

8）icon：QIcon 访问函数：QIcon icon() const; void setIcon(const QIcon &);
按钮上显示的图标。

9）iconSize：QSize 访问函数：QSize iconSize() const; void setIconSize(const QSize);
按钮上显示的图标的大小。默认大小由 GUI 样式定义。这是图标的最大大小，较小的图标不会被放大。

10）shortcut ：QKeySequence
访问函数：QKeySequence shortcut() const; void setShortcut(const QKeySequence&);
保存与按钮关联的助记符，QKeySequence 类型见后文

11）text：QString 访问函数：QString text()const; void setTex t(const QString&);
按钮上显示的文本。若按钮没有文本，则 text()返回一个空字符串。

QAbstractButton 类中的常见函数

1）QAbstractButton(QWidget *parent=Q_NULLPTR); //构造函数

2）QButtonGroup* group() const //该函数见后文。
返回此按钮所属的组，若按钮不是任何 QButtonGroup 的成员，则返回 0。

QAbstractButton 类中的信号

1）void clicked(bool checked =false);
以下情形会发送此信号：

• 鼠标点击按钮然后释放时，注意：按钮释放时才会发送。
• 调用 click()或 animateClick()函数时。
• 按下对应的快捷键或空格键时。
• 当调用 setDown()、setChecked()或 toggle()函数时，不会发送该信号。
• 若按钮是可选中的，当按钮被选中时，参数 checked 为 true，若按钮未被选中，则为 false。
• 需要注意的是 QWidget 类并不发送此信号及 pressed 和 released 信号。

2）void pressed(); 按下按钮时发送此信号

3）void released(); 释放按钮时发送此信号。

4）void toggled(bool checked);

• 每当可选中按钮切换状态时，都会发送此信号。若按钮被选中，则参数 checked为 true，若按钮被取消选中，则为 false。
• 按钮状态的改变可能是由于用户操作，click()槽函数或 setChecked()函数被调用的
  结果。
• 在发出信号前，将更新排他性按钮组中按钮的状态，

QAbstractButton 类中的槽函数

1）void animateClick(int m=100);
执行动画单击：即，立即按下按钮，然后在 m 毫秒之后释放。在释放按钮之前再次调用此函数，会重新设置计时器。所有与单击有关的信号都会根据情况发出。若该按钮被禁用，则此功能不起作用。

2）void click()
此槽接收来自与点击相关的常见信号，若按钮是可选中的，则切换该按钮的状态。若该按钮被禁用，则此槽函数不起作用。

3）void toggle(); 切换可选中按钮的状态。

QAbstractButton 类中的虚函数(受保护的)

1）void checkStateSet()
当使用 setChecked()时，会调用此虚函数，除非它是在 nextCheckState()中调用的。它允许子类重置其中间按钮状态。

2）bool hitButton(const QPoint &pos) const;
若 pos 位于可单击按钮的矩形内，则返回 true，否则返回 false。可单击区域默认是整个部件，子类可重新实现此函数，以提供对不同形状和大小的可单击区域的支持。

3）void nextCheckState()
当按钮被单击时，调用此虚函数，该函数允许子类实现中间按钮状态。

4）void paintEvent(QPaintEvent* e)=0; 这是个纯虚函数，子类必须重新实现该函数。

标准按钮控件QPushButton 类

QPushButton 类介绍

默认按钮：是指当用户按下 enter 时，默认按钮会被自动按下。

自动默认按钮：是指在满足一些条件时会自动成为默认按钮的按钮，比如当自动默认按钮获得焦点时，会自动成为默认按钮，普通按钮即使获得焦点也不会成为默认按钮。

默认按钮和自动默认按钮，在其周围通常会绘制一个额外的边框，最多可达 3 个像素或更多，Qt 会保留这个空间在默认按钮的周围，因此，自动默认按钮和默认按钮可能会有更大的默认尺寸。在 Qt 中，自动默认按钮不会显示这个边框，但默认按钮会显示，因此，从外观上看，有这个边框的按钮就是默认按钮。

默认按钮基本规则：

• 一次只能有一个按钮是默认按钮，若同时设置多个默认按钮，则最后设置的按钮是默认按钮。
• 按下空格键始终单击的是具有焦点的按钮(这是按下空格键与 enter 键的不同)。
• 应使用信号和槽，而不是事件来响应默认按钮的操作。比如对于默认按钮，应把clicked()、pressed()或 released()信号与某个槽关联，以响应默认按钮按下时的操作，若使用鼠标或键盘事件，将不能达到预期的效果，因为按下 enter 键不是鼠标事件，而键盘事件会接收来自键盘的所有按键的事件。
• 经测试，QPushButton 的 autoRepeat (自动重复)属性对默认按钮无效，也就是说即使关闭自动重复，当按下 enter 键时，仍会重复发送信号，注意，仅针对按下 enter 键，若按下的是空格键，则自动重复是有作用的。

默认按钮与自动默认按钮的行为：默认按钮的行为仅在对话框中有作用，也就是说若不是在对话框中，则不一定按以下规则执行。

• 按下 enter (回车)键时，若自动默认按钮当前具有焦点，则按下自动默认按钮。
• 按下 enter (回车)键时，若对话框中有自动默认按钮但没有默认按钮，则按下当前具有焦点的自动默认按钮，若此时没有按钮具有焦点，则按下焦点链中的下一个自动默认按钮。

QPushButton 类中的属性函数

1）autoDefault：bool 访问函数：bool autoDefault() const; void setAutoDefault(bool);
若此属性为 true，则此按钮是一个自动默认按钮。若按钮的父部件是 QDialog，则此
属性的默认值为 true，否则为 false。
2）default：bool 访问函数：bool isDefault() const; void setDefault(bool);
此属性描述了是否为默认按钮。默认为 false。
3）flat：bool 访问函数：bool isFlat() const; void setFlat(bool);
此属性描述了是否提高按钮的边框。若此属性为 true，大多数样式不会绘制按钮的背景，除非按下按钮。也就是说，若该属性为 true，在通常情况下，若不按下按钮，则该按钮看起来就像一个标签一样，是平的。setAutoFillBackground() 函数可确保使用QPalette::Button 画刷填充背景。默认为 false。

QPushButton 类中的常用函数

1）QPushButton (QWidget* parent = Q_NULLPTR);
QPushButton (const QString &text , QWidget* parent = Q_NULLPTR)
QPushButton (const QIcon &icon , const QString &text , QWidget* parent = Q_NULLPTR)

2）QMenu* menu() const;
返回与此按钮相关的弹出菜单，若未设置弹出菜单，则返回 0。菜单详见相关章节

3）void setMenu (QMenu * menu);
将弹出菜单 menu 与按钮关联，这会使按钮成为菜单按钮。

4）void showMenu(); //槽
显示(弹出)与此按钮相关联的弹出菜单，若没有菜单，则什么也不做。在用户关闭弹出菜单之前，该函数不会返回。

复选按钮控件QCheckBox 类

复选按钮的第三状态(见下图 的选中状态)：是指除了选中和未选中状态之外的第三种状态，这种状态用来指示“不变”，表示用户既不选中也不取消选中该复选按钮。可使用 setTristate()函数启用这种状态，使用 checkState()检查按钮的当前状态。

QCheckBox 类的常见函数

1）tristate：bool 访问函数：bool isTristate() const; void setTristate(bool y=true);
该属性保存复选按钮是否为三态按钮，默认为 false。注意：属性的设置函数 setTristate只能设置此按钮具有三态按钮的形式，但不能使该按钮呈现出第三种状态，即按钮前面的小方框内不会有小黑方框的填充，但点击该按钮，会在三种状态间变换。设置按钮的状态应使用下面介绍的成员函数 setCheckState()。

2）QCheckBox(QWidget* parent = Q_NULLPTR); //构造函数
QCheckBox(const QString &text , QWidget* parent = Q_NULLPTR);

3）Qt::CheckState checkState() const; //返回复选框的选中状态。

4）void setCheckState(Qt::CheckState state);
设置复选按钮的状态为 state ，该函数可设置复选按钮的三种状态，QAbstractButton::setChecked()只能设置两种状态。Qt::CheckState 枚举如下：

• Qt::Unchecked：未选中
• Qt::PartiallyChecked：部分被选中，一个项目中的子项目被选中(但不是全部)，则该项目就是部分选中状态。
• Qt::Checked： 选中

5）void stateChanged(int state); //信号
当复选按钮的状态发生变化时发送该信号。若复选按钮具有三态形式，则按钮会在“选中、未选中、部分选中”三种状态间变化，只要这三种状态变化都会发送该信号，但QAbstractButton::toggled()信号在三种状态间变化时，则不一定会发送。

单选按钮控件QRadioButton 类

单选按钮默认是具有排他性的，还要注意的是单选按钮没有第三种状态。

单选按钮比较简单，其成员仅有构造函数，其余成员都是继承自父类或重新实现的父类中的函数，其构造函数如下所示：
QRadioButton(QWidget* parent = Q_NULLPTR);
QRadioButton(const QString &text , QWidget* parent = Q_NULLPTR)

工具按钮控件QToolButton 类

QToolButton 类介绍

工具按钮通常不显示文本标签，仅仅是一个图标。

工具按钮通常还具有自动提升的样式，即当鼠标指向该按钮时，按钮会虽现 3D 效果。当工具按钮位于 QToolBar( 工具栏 ) 中时，会自动打开该功能，可通过使用QToolButton::setAutoRaise()进行设置。

工具按钮还可以具有弹出式菜单，通常该菜单会延迟一段时间才会显示，最常见的是“返回”按钮，当按住“返回”按钮一段时间后，会弹出一个菜单，如下图。

工具按钮通常需要添加一个 QAction 实例，这个实例主要用于响应按下工具按钮应该响应的动作，使用该实例可使菜单和工具按钮的动作保持同步(一致)。有关该实例的具体内容请参阅相关章节。

QToolButton 类中的属性函数

1）arrowType：Qt::ArrowType
访问函数：Qt::ArrowType arrowType() const;void setArrowType(Qt::Ar