PyQt5 GUI编程（组件使用）

一.简介

PyQt5 是一个用于创建图形用户界面（GUI）应用程序的 Python 绑定，它基于 Qt 库。PyQt5 提供了大量的组件（也称为控件或部件），用于构建复杂的用户界面。以下是一些常用的 PyQt5 组件

二.组件用法

1.数字组件（QLCDNumber）

class FileChooserApp(QWidget):
    def __init__(self):
        super().__init__()
        self.initUI()

    def initUI(self):
        lcd = QLCDNumber()  # 创建一个数字控件
        sld = QSlider(Qt.Horizontal)  # 创建一个进度条控件
        vbox = QVBoxLayout()  # 创建一个垂直布局
        vbox.addWidget(lcd)
        # vbox.addStretch(1)
        vbox.addWidget(sld)

        self.setLayout(vbox)  # 添加到布局器中
        sld.valueChanged.connect(lcd.display)  # 将数字和进度条联动绑定在一起

        self.setWindowTitle('文件选择器')
        self.setGeometry(300, 300, 500, 500)

上述中创建了一个数字组件和一个进度条组件，两者绑定在一起，通过滑动进度条来改变数字。

2.快捷键（Key_Space）

    def keyPressEvent(self, e):  # 重写keyPressEvent
        if e.key() == Qt.Key_Space:  # 如果按下空格键退出程序，Qt.Key_Escape也可写成具体的数字32
            print("事件")
            self.close()

除了Qt.Key_Space外还有上千种快捷操作，可以在封装好的Qt.py下查看，这里列举几个最常用的。

Qt.Key_Return 或 Qt.Key_Enter	代表回车键
Qt.Key_Space	代表空格键
Qt.Key_A 到 Qt.Key_Z	代表 A 到 Z 的字母键
Qt.Key_0 到 Qt.Key_9	代表 0 到 9 的数字键
Qt.Key_F1 到 Qt.Key_F12	代表功能键 F1 到 F12
Qt.Key_Tab	代表 Tab 键
Qt.Key_Backspace	代表退格键（Backspace）
Qt.Key_Delete	代表删除键
Qt.Key_Home和 Qt.Key_End	代表 Home 和 End 键
Qt.Key_Left, Qt.Key_Right, Qt.Key_Up, Qt.Key_Down	代表方向键
Qt.Key_Plus 和 Qt.Key_Minus	代表加号（+）和减号（-）键（注意，这些与数字键盘上的加减号不同）
Qt.Key_PageUp 和 Qt.Key_PageDown	代表翻页键

3.鼠标位置跟踪

class FileChooserApp(QWidget):
    def __init__(self):
        super().__init__()
        self.initUI()

    def initUI(self):
        x = 0
        y = 0

        text = "x: {0},y: {1}".format(x, y)  # 设置默认值0，0
        self.label = QLabel(text, self)  # 坐标添加到laber组件里
        self.label.resize(150, 20)  # 设置组件长宽
        self.setMouseTracking(True)  # x,y显示在laber组件里
        self.setGeometry(300, 300, 350, 200)
        self.setWindowTitle('鼠标坐标')

    # 鼠标位置跟踪
    def mouseMoveEvent(self, e):  # e表示当前鼠标对象，x(),y()得到鼠标x,y坐标
        x = e.x()
        y = e.y()
        text = "x: {0},y: {1}".format(x, y)
        self.label.setText(text)

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

注释写的很清楚了，这里直接演示效果。鼠标在界面内移动，坐标实时显示，

4.事件发送，获取触发事件的信息

class FileChooserApp(QMainWindow):
    def __init__(self):
        super().__init__()
        self.initUI()

    # 事件发送，获取某个事件行为
    def initUI(self):
        btn1 = QPushButton("Button 1", self)
        btn1.move(30, 50)

        btn2 = QPushButton("Button 2", self)
        btn2.move(150, 50)

        btn1.clicked.connect(self.click)
        btn2.clicked.connect(self.click)

        self.statusBar()  # 底部状态栏

        self.setGeometry(500, 500, 290, 150)
        self.setWindowTitle('button')

    def click(self):
        sender = self.sender()  # 用于接收信号
        self.statusBar().showMessage(sender.text())  # 状态栏设置点击按钮的内容

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

当我们点击两个按钮中任意一个时，sender()方法接收信号的来源于，来判断是点击哪个按钮触发的信号。

5.可输入内容弹框（QInputDialog）

class FileChooserApp(QMainWindow):
    def __init__(self):
        super().__init__()
        self.initUI()

    # 二级输入弹框
    def initUI(self):
        self.btn = QPushButton('Dialog', self)
        self.btn.move(20, 20)
        self.btn.clicked.connect(self.showDialog)

        self.le = QLineEdit(self)
        self.le.move(130, 22)

        self.setGeometry(500, 500, 290, 150)
        self.setWindowTitle('Input dialog')

    def showDialog(self):
        """
        QInputDialog创建弹框，第一个参数表示弹框title，第二个参数表示输入框说明
        text为输入后返回的内容
        ok：bool类型，ok为true，false为cancel
        """

        text, ok = QInputDialog.getText(self, 'Input Dialog',
                                        '输入你的名字')

        if ok:
            self.le.setText(str(text))

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

点击按钮时触发QInputDialog弹框，输入内容点击ok时，将输入的内容赋予QLineEdit中。

6.颜色组件（QColor）

class FileChooserApp(QMainWindow):
    def __init__(self):
        super().__init__()
        self.initUI()

    # 选择颜色
    def initUI(self):
        col = QColor(0, 0, 0)  # 初始化QFrame颜色

        self.btn = QPushButton('Dialog', self)
        self.btn.move(20, 20)

        self.btn.clicked.connect(self.showDialog)

        self.frm = QFrame(self)
        self.frm.setStyleSheet("QWidget { background-color: %s }"
                               % col.name())  # 设置QFrame样式，col.name() 返回的是一个有效的颜色值
        self.frm.setGeometry(130, 22, 100, 100)

        self.setGeometry(300, 300, 250, 180)
        self.setWindowTitle('Color dialog')

    def showDialog(self):
        col = QColorDialog.getColor()  # 弹出颜色选择框
        if col.isValid():  # true设置颜色，false返回
            self.frm.setStyleSheet("QWidget { background-color: %s }"
                                   % col.name())

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

点击按钮时弹出颜色选择框（QColorDialog.getColor()），选择颜色后isValid()判断是否已选择，或者取消选择。

7.文字字体类型组件

class FileChooserApp(QMainWindow):
    def __init__(self):
        super().__init__()
        self.initUI()

    def initUI(self):
        btn = QPushButton('选择字体', self)
        btn.setSizePolicy(QSizePolicy.Fixed,
                          QSizePolicy.Fixed)

        btn.move(20, 20)

        btn.clicked.connect(self.showDialog)
        self.ql = QLineEdit(self)
        self.ql.move(150,20)

        self.setGeometry(500, 500, 250, 180)
        self.setWindowTitle('字体')

    def showDialog(self):
        font, ok = QFontDialog.getFont()  # 打开文本选择框，font为返回的格式，ok为true
        if ok:
            self.ql.setFont(font)

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

点击按钮时弹出字体类型选择框（QFontDialog.getFont()），选择字体后返回一个字体类型和一个bool值，判断是否已选择，或者取消选择。

8.复选框（QCheckBox）

    # 复选框
    def initUI(self):
        self.laber = QLabel(self)
        self.laber.setText("初始值")
        self.laber.move(150, 20)
        cb = QCheckBox('复选框', self)  # 创建一个复选框，
        cb.move(20, 20)
        cb.toggle()
        """
            切换复选框的选中状态。如果复选框当前是未选中的，它将被选中；如果它是已选中的，它将被取消选中。
            默认情况下，新创建的复选框是未选中的。因此，调用toggle()将使其变为选中状态
            """
        cb.stateChanged.connect(self.changeTitle)  # stateChanged选择状态发送变化时

        self.setGeometry(500, 500, 250, 150)
        self.setWindowTitle('QCheckBox')

    def changeTitle(self, state):

        if state == Qt.Checked:  # 当选中时，重置文本
            self.laber.setText("已选中")
        else:
            self.laber.setText("未选中")  # 当未选中时，重置文本

效果如下

9.按钮状态切换

    def initUI(self):
        self.col = QColor(0, 0, 0)  # 初始值为黑色
        redb = QPushButton('Red', self)
        redb.setCheckable(True)
        redb.move(10, 10)
        redb.clicked[bool].connect(self.setColor)  # 返回bool类型

        greenb = QPushButton('greenb', self)
        greenb.setCheckable(True)  # 设置按钮为可选择按钮
        greenb.move(100, 10)
        greenb.clicked[bool].connect(self.setColor)  # 返回bool类型

        blueb = QPushButton('blueb', self)
        blueb.setCheckable(True)
        blueb.move(200, 10)
        blueb.clicked[bool].connect(self.setColor)  # 返回bool类型

        self.frame = QFrame(self)
        self.frame.move(100, 100)
        self.frame.setStyleSheet("QFrame { background-color: %s }"
                                 % self.col.name())  # 设置QFrame样式，col.name() 返回的是一个有效的颜色值

    def setColor(self, status):
        sender = self.sender()  # 获取信号源
        if status:
            val = 255  # 颜色深度
        else:
            val = 0  #
        if sender.text() == "Red":
            self.col.setRed(val)  # 设置color为红色
        elif sender.text() == "greenb":
            self.col.setGreen(val)  # 设置颜色，数字表示颜色深度
        elif sender.text() == "blueb":
            self.col.setBlue(val)
        self.frame.setStyleSheet("QWidget { background-color: %s }"
                                 % self.col.name())  # 设置QFrame样式，col.name() 返回的是一个有效的颜色值

创建了三个按钮，分别是红，绿，蓝，设置按钮为可选择按钮。当点击按钮时，发送信号给槽，返回一个bool值，setcolor接收这个bool值，判断为true时，设置颜色深度，并通过sender()来获取是哪个按钮被点击了，从而设置QFrame的值。

上面实例中有个小缺陷，在选中一个按钮是，应当判断其它按钮有没有被选中，若选中需取消选择，这样不会出现颜色偏差。

10.滑块组件

 # 滑块
    def initUI(self):
        sld_h = QSlider(Qt.Horizontal, self)  # 设置水平滑块
        sld_h.move(0,0)
        sld_v = QSlider(Qt.Vertical, self)  # 设置垂直滑块
        sld_v.move(0,100)
        sld_h.setFocusPolicy(Qt.NoFocus)  # 设置水平滑块键盘不可滑动
        # 设置滑块的范围
        sld_h.setRange(0, 100)
        # 设置滑块的初始值
        sld_h.setValue(0)
        sld_h.setValue(50)
        sld_h.valueChanged[int].connect(self.slider)  # 返回一个数字

        self.label = QLabel(self)
        self.label.setText("初始值")
        # self.label.setPixmap(QPixmap('mute.png'))  # 可将label控件添加图片，可以制作音量调节
        self.label.move(200,0)

        self.setGeometry(500,500,500,500)

    def slider(self, i):  # 接收数字时判断
        if i == 0:
            self.label.setText("最小值")
        elif 0 < i < 50:
            self.label.setText("中间值")
        else:
            self.label.setText("最大值")

11.日志

    # 日历
    def initUI(self):
        cal = QCalendarWidget(self)  # 创建一个日历控件
        cal.setGridVisible(False)  # 设置控件网格是否可见，True可见
        cal.clicked[QDate].connect(self.showDate)  # 返回一个基于pyqt5的日期格式
        self.lbl = QLabel(self)
        self.lbl.move(0, 350)
        date = cal.selectedDate()  # 获取当前时间
        print(date)
        self.lbl.setText(date.toString())  # 设置默认展示当前时间
        self.setGeometry(500, 500, 500, 500)

    def showDate(self, data):
        self.lbl.setText(data.toString())

12.下拉框

import sys

from PyQt5.QtWidgets import QWidget, QApplication, QLabel, QComboBox

class Example(QWidget):

    def __init__(self):
        super().__init__()

        self.initUI()

    # 下拉框
    def initUI(self):
        self.lbl = QLabel("Ubuntu", self)

        combo = QComboBox(self)  # 创建一个下拉框控件
        combo.addItem("红")
        combo.addItem("黄")
        combo.addItem("绿")
        combo.addItem("青")
        combo.addItem("蓝")

        combo.move(50, 50)
        self.lbl.move(50, 150)

        combo.activated[str].connect(self.onActivated)  # 当下拉框索引发送变化时，返回一个选择值

        self.setGeometry(300, 300, 300, 200)
        self.setWindowTitle('QComboBox')

    def onActivated(self, st):
        self.lbl.setText(st)
        self.lbl.adjustSize()  # 自定义适配长度

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