基本界面组件之Button(1)

Button，作为界面中触发动作请求或者命令的一种方式，作为与用户进行的交互操作。PyQt中的Button根据不同的使用场景划分为不同的表现形式。Button的基类QAbstractButton，提供button的通用性功能，此类为抽象类，从因此不能实例化，由其他的Button类继承来实现不同的功能，不同的表现形式。 
常见的Button包括，QPushButton，QToolButton，QRadioButton及QCheckBox。这些Button类均继承自QAbstractButton类，根据各自的使用场景通过图形展现出来。

抽象类 QAbstractButton：

QAbstractButton作为抽象类，提供button的通用功能，可按按钮（push button）和可选择按钮（checkable button）。可选择按钮实现有QRadioButton和QCheckBox；可按按钮实现有QPushButton和QToolButton。 
任何一种button可以显示带文本(.setText()方法设置文本)和图标(.setIcon()设置图标)的标签。

QAbstractButton 提供的状态： 
1、isDown() 提示button是否按下 
2、isChecked()提示button是否已经标记 
3、isEnable()提示button是否可以被用户点击 
4、isCheckAble()提示button是否为可标记 
5、setAutoRepeat()设置button是否在用户长按按钮的时候可以自动重复执行。

QAbstractButton 提供的信号： 
1、pressed(),当鼠标在button上并点击左键的时候 触发信号 
2、released(),当鼠标左键被释放的时候触发信号 
3、clicked(),当鼠标首次按下，然后释放，或者快捷键被释放的时候触发信号 
4、toggled(),当button的标记状态发生改变的时候触发信号

接下来会针对每一种button进行介绍：

QPushButton ：

class QPushButton(QAbstractButton)
 |  QPushButton(Qwidget parent=None)
 |  QPushButton(str, Qwidget parent=None)
 |  QPushButton(Qicon, str, Qwidget parent=None)

由此可见QPushButton继承自QAbstractButton,是一种command按钮。点击执行一些命令，或者响应一些问题。常见的诸如“确认”，“申请”，“取消”，“关闭”，“是”，“否”等按钮。 
Command Button经常通过文本来描述执行的动作。有时候我们也会通过快捷键来执行对应按钮的命令。

通过一个示例对QPushButton来进行说明：

#-*- coding:utf-8 -*-
'''
PushButton
'''

from PyQt5.QtWidgets import Qapplication, Qwidget, QPushButton
from PyQt5.QtGui import Qicon
from PyQt5.QtCore import Qt
import sys


class PushButton(Qwidget):
    def __init__(self):
        super(PushButton,self).__init__()
        self.initUI()
    def initUI(self):
        self.setWindowTitle("PushButton")
        self.setGeometry(400,400,300,260)

        self.closeButton = QPushButton(self)
        self.closeButton.setText("Close")          #text
        self.closeButton.setIcon(Qicon("close.png")) #icon
        self.closeButton.setShortcut('Ctrl+D')  #shortcut key
        self.closeButton.clicked.connect(self.close)
        self.closeButton.setToolTip("Close the widget") #Tool tip
        self.closeButton.move(100,100)

if __name__ == '__main__':
    app = Qapplication(sys.argv)
    ex = PushButton()
    ex.show()
    sys.exit(app.exec_()) 

运行之后的效果： 

控件说明：

示例说明： 
名称为“Close”的 Buttton，点击该Button之后关闭该窗口。或者通过快捷键“Ctrl+C”的快捷方式亦可关闭该窗口。 
代码分析： 
其他代码部分可以参考上一篇《Pyqt5系列(二 )-第一个PyQt程序》中的说明。

L21~22：

self.closeButton.setText("Close")          #text
self.closeButton.setIcon(Qicon("close.png")) #icon

setText()方法，设定button的文本 
setIcon()方法，设定button的图标 
关于button 文本和图标的显示，也可以通过QPushButton的构造函数，在创建对象实例的时候通过参数直接设定。 
| QPushButton(str, Qwidget parent=None) 
| QPushButton(Qicon, str, Qwidget parent=None)

L23：

self.closeButton.setShortcut('Ctrl+D')  #shortcut key

给closeButton设定快捷键方式，即通过Ctrl+D实现与点击closeButton一样的功能。

L24:

self.closeButton.clicked.connect(self.close)

closeButton点击事件处理的逻辑：在点击closeButton之后调用Qwidget的close()方法。通过connect()方法将点击事件和处理逻辑关联起来 。

L25：

self.closeButton.setToolTip("Close the widget")

setToolTip()设定提示信息，当鼠标移动到button上时显示”Close the widget”提示信息。

QToolButton：

class QToolButton(QAbstractButton)
 |  QToolButton(Qwidget parent=None)

同理QToolButton继承自QAbstractButton。QToolButton就是工具操作相关的按钮,通常和QToolBar搭配使用。QToolButton通常不显示文本，而显示图标Qicon。一般QToolButton会在QToolBar：：addAction时创建，或者已经存在的action添加到QToolBar时创建。

通过一个示例对QToolButton来进行说明：

#-*- coding:utf-8 -*-
'''
ToolButton
'''

from PyQt5.QtWidgets import Qapplication, Qwidget, QToolButton, QMainWindow
from PyQt5.QtGui import Qicon
from PyQt5.QtCore import Qt
import sys


class ToolButton(QMainWindow):
    def __init__(self):
        super(ToolButton,self).__init__()
        self.initUI()
    def initUI(self):
        self.setWindowTitle("ToolButton")
        self.setGeometry(400,400,300,260)

        self.toolbar = self.addToolBar("toolBar")
        self.statusBar()

        self._detailsbutton = QToolButton()                                     
        self._detailsbutton.setCheckable(True)                                  
        self._detailsbutton.setChecked(False)                                   
        self._detailsbutton.setArrowType(Qt.RightArrow)
        self._detailsbutton.setAutoRaise(True)
        #self._detailsbutton.setIcon(Qicon("test.jpg"))
        self._detailsbutton.setToolButtonStyle(Qt.ToolButtonIconOnly)
        self._detailsbutton.clicked.connect(self.showDetail)
        self.toolbar.addWidget(self._detailsbutton)

    def showDetail(self):
        if self._detailsbutton.isChecked():
            self.statusBar().showMessage("Show Detail….")
        else:
            self.statusBar().showMessage("Close Detail….")

if __name__ == '__main__':
    app = Qapplication(sys.argv)
    ex = ToolButton()
    ex.show()
    sys.exit(app.exec_()) 

运行之后的效果： 

控件说明：

示例说明： 
图标为“右箭头图标”的 Buttton，此按钮有开关之分。当Button打开之后在消息栏显示“Show Detail….”,反之显示“Close Detail”。 
代码分析： 
其他代码部分可以参考上一篇《Pyqt5系列(二 )-第一个PyQt程序》中的说明。 
L24~25:

self._detailsbutton.setCheckable(True)
self._detailsbutton.setChecked(False)

setCheckable()方法，“True”设置该button为可选属性，及存在“开”和“关”两种状态。 
setChecked()方法，设置button的状态为为选中的状态。

L26:

self._detailsbutton.setArrowType(Qt.RightArrow)

setArrowType()方法，设定button上显示的箭头类型 
arrowType，箭头属性，按钮是否显示一个arrow代替正常的icon 
Qt.NoArrow 0 
Qt.UpArrow 1 
Qt.DownArrow 2 
Qt.LeftArrow 3 
Qt.RightArrow 4

L29:

self._detailsbutton.setToolButtonStyle(Qt.ToolButtonIconOnly)

setToolButtonStyle()，设定button文本和图标显示的样式。程序中的参数为只显示icon不显示文本（Qt.ToolButtonIconOnly） 
参数类型如下： 
Qt.ToolButtonIconOnly 0 Only display the icon. 
Qt.ToolButtonTextOnly 1 Only display the text. 
Qt.ToolButtonTextBesideIcon 2 The text appears beside the icon. 
Qt.ToolButtonTextUnderIcon 3 The text appears under the icon. 
Qt.ToolButtonFollowStyle 4

如果在实际的使用过程中，需要同时显示自定义的icon和文本的时候，可以按照如下参数设置：

self._detailsbutton.setIcon(Qicon("test.jpg"))
self._detailsbutton.setToolButtonStyle(Qt.ToolButtonTextBesideIcon)

对于QPushButton和QToolButton，如上的例子中只是涉及到部分常用的方法，所以对于详细的说明可以通过如下两个途径：

1.    PyQt5 Class Reference 网站： 
http://pyqt.sourceforge.net/Docs/PyQt5/class_reference.html

2.    在命令行中通过help()方法： 
如 help(QPushButton)