PyQt5控件

控件

控件就像是应用这座房子的一块块砖。PyQt5有很多的控件，比如按 钮，单选框，滑动条，复选框等等

控件： QCheckBox ， ToggleButton ， QSlider ， QProgressBar 和 QCale ndarWidget

一、QCheckBox

QCheckBox 组件有俩状态：开和关。通常跟标签一起使用，用在激活和 关闭一些选项的场景

例子中，有一个能切换窗口标题的单选框

代码实现：

from PyQt5.QtWidgets import QWidget, QCheckBox, QApplication
from PyQt5.QtCore import Qt
import sys


class Example(QWidget):
    def __init__(self):
        super().__init__()

        self.initUI()

    def initUI(self):
        # 这个是 QCheckBox 的构造器
        cb = QCheckBox('Show title', self)
        cb.move(20, 20)
        # 要设置窗口标题，我们就要检查单选框的状态，
        # 默认情况下，窗口没有 标题，单选框未选中
        cb.toggle()
        # 把 changeTitle() 方法和 stateChanged 信号关联起来。
        # 这样， changeTitle() 就能切换窗口标题了
        cb.stateChanged.connect(self.changeTitle)
        self.setGeometry(300, 300, 250, 150)

        self.setWindowTitle('QCheckBox')
        self.show()

    # 控件的状态是由 changeTitle() 方法控制的，
    # 如果空间被选中，我们就 给窗口添加一个标题，
    # 如果没被选中，就清空标题
    def changeTitle(self, state):
        if state == Qt.Checked:
            self.setWindowTitle('QCheckBox')
        else:
            self.setWindowTitle(' ')


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

程序预览：

二、切换按钮

切换按钮就是 QPushButton 的一种特殊模式。 它只有两种状态：按下和未按下。我们再点击的时候切换两种状态，有很多场景会使用到这个功能

例子中创建了一个切换按钮和一个 QWidget ，并把 QWidget 的背景设置 为黑色。点击不同的切换按钮，背景色会在红、绿、蓝之间切换（而且 能看到颜色合成的效果，而不是单纯的颜色覆盖）

代码实现：

from PyQt5.QtWidgets import (QWidget, QPushButton,
                             QFrame, QApplication)
from PyQt5.QtGui import QColor
import sys


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

    def initUI(self):
        # 设置黑色颜色
        self.col = QColor(0, 0, 0)
        # 创建一个 QPushButton按钮
        redb = QPushButton('Red', self)
        # 调用setCheckable()把按钮变成切换按钮
        redb.setCheckable(True)
        redb.move(10, 10)
        # 把点击信号和我们定义好的函数关联起来,把点击事件转换成布尔值
        redb.clicked[bool].connect(self.setColor)
        greenb = QPushButton('Green', self)
        greenb.setCheckable(True)
        greenb.move(10, 60)
        greenb.clicked[bool].connect(self.setColor)
        blueb = QPushButton('Blue', self)
        blueb.setCheckable(True)
        blueb.move(10, 110)
        blueb.clicked[bool].connect(self.setColor)
        self.square = QFrame(self)
        self.square.setGeometry(150, 20, 100, 100)
        self.square.setStyleSheet("QWidget { background-color: %s }" % self.col.name())
        self.setGeometry(300, 300, 280, 170)
        self.setWindowTitle('Toggle button')
        self.show()

    def setColor(self, pressed):
        # 获取被点击的按钮
        source = self.sender()

        if pressed:
            val = 255
        else:
            val = 0
        # 如果是标签为“red”的按钮被点击，
        # 就把颜色更改为预设好的对应颜色
        if source.text() == "Red":
            self.col.setRed(val)
        elif source.text() == "Green":
            self.col.setGreen(val)
        else:
            self.col.setBlue(val)
        # 使用样式表（就是CSS的SS）改变背景色
        self.square.setStyleSheet("QFrame { background-color: %s }" % self.col.name())


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

程序预览：

三、滑块

QSlider 是个有一个小滑块的组件，这个小滑块能拖着前后滑动，这个 经常用于修改一些具有范围的数值，比文本框或者点击增加减少的文本 框（spin box）方便多了

例子中用一个滑块和一个标签展示。标签为一个图片，滑块控制标签（的 值）

代码实现：

from PyQt5.QtWidgets import (QWidget, QSlider, QLabel, QApplication)
from PyQt5.QtCore import Qt
from PyQt5.QtGui import QPixmap
import sys


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

    def initUI(self):
        # 创建一个水平的 QSlider
        sld = QSlider(Qt.Horizontal, self)
        sld.setFocusPolicy(Qt.NoFocus)
        sld.setGeometry(30, 40, 100, 30)
        # 把 valueChanged 信号跟 changeValue() 方法关联起来
        sld.valueChanged[int].connect(self.changeValue)

        # 创建一个 QLabel 组件并给它设置一个静音图标
        self.label = QLabel(self)
        self.label.setPixmap(QPixmap('default.png'))
        self.label.setGeometry(160, 40, 80, 30)

        self.setGeometry(300, 300, 280, 170)
        self.setWindowTitle('QSlider')

        self.show()

    # 根据音量值的大小更换标签位置的图片
    def changeValue(self, value):
        if value == 0:
            self.label.setPixmap(QPixmap('default.png'))
        elif value > 0 and value <= 30:
            self.label.setPixmap(QPixmap('default.png'))
        elif value > 30 and value < 80:
            self.label.setPixmap(QPixmap('default.png'))
        else:
            self.label.setPixmap(QPixmap('default.png'))


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

程序预览：

四、进度条

进度条是用来展示任务进度的（我也不想这样说话）。它的滚动能让用 户了解到任务的进度。 QProgressBar 组件提供了水平和垂直两种进度条，进度条可以设置最大值和最小值，默认情况是0~99

例子中创建了一个水平的进度条和一个按钮，这个按钮控制进度条的开始和停止

代码实现：

from PyQt5.QtWidgets import (QWidget, QProgressBar,
                             QPushButton, QApplication)
from PyQt5.QtCore import QBasicTimer
import sys


class Example(QWidget):
    def __init__(self):
        super().__init__()

        self.initUI()

    def initUI(self):
        # 新建一个 QProgressBar 构造器
        self.pbar = QProgressBar(self)
        self.pbar.setGeometry(30, 40, 200, 25)
        self.btn = QPushButton('Start', self)
        self.btn.move(40, 80)
        self.btn.clicked.connect(self.doAction)
        # 用时间控制进度条
        self.timer = QBasicTimer()
        self.step = 0
        self.setGeometry(300, 300, 280, 170)
        self.setWindowTitle('QProgressBar')
        self.show()

    # 每个 QObject 和又它继承而来的对象都有一个 timerEvent()
    # 事件处理函数。为了触发事件，我们重载了这个方法
    def timerEvent(self, e):
        if self.step >= 100:
            self.timer.stop()
            self.btn.setText('Finished')
            return

        self.step = self.step + 1
        self.pbar.setValue(self.step)

    # 用来控制开始和停止的
    def doAction(self):
        if self.timer.isActive():
            self.timer.stop()
            self.btn.setText('Start')
        else:
            # 调用 start() 方法加载一个时间事件
            self.timer.start(100, self)
            self.btn.setText('Stop')


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

程序预览：

五、日历

QCalendarWidget 提供了基于月份的日历插件，十分简易而且直观

例子有日期组件和标签组件组成，标签显示被选中的日期

代码实现：

from PyQt5.QtWidgets import (QWidget, QCalendarWidget,
                             QLabel, QApplication, QVBoxLayout)
from PyQt5.QtCore import QDate
import sys


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

    def initUI(self):
        vbox = QVBoxLayout(self)
        # 创建一个 QCalendarWidget
        cal = QCalendarWidget(self)
        cal.setGridVisible(True)
        # 选择一个日期时， QDate 的点击信号就触发了，
        # 把这个信号和我们自 己定义的 showDate() 方法关联起来
        cal.clicked[QDate].connect(self.showDate)

        vbox.addWidget(cal)
        self.lbl = QLabel(self)
        # 获取选中的日期
        date = cal.selectedDate()
        self.lbl.setText(date.toString())
        vbox.addWidget(self.lbl)
        self.setLayout(vbox)
        self.setGeometry(300, 300, 350, 300)
        self.setWindowTitle('Calendar')
        self.show()

    # 把日期对象转成字符 串，在标签里面显示出来
    def showDate(self, date):
        self.lbl.setText(date.toString())


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

程序预览：

六、图片

QPixmap 是处理图片的组件。本例中，我们使用 QPixmap 在窗口里显示一张图片

代码实现：

from PyQt5.QtWidgets import (QWidget, QHBoxLayout,
                             QLabel, QApplication)
from PyQt5.QtGui import QPixmap
import sys


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

    def initUI(self):
        hbox = QHBoxLayout(self)
        # 创建一个 QPixmap 对象，接收一个文件作为参数
        pixmap = QPixmap("default.png")
        # 把 QPixmap 实例放到 QLabel 组件里
        lbl = QLabel(self)
        lbl.setPixmap(pixmap)
        hbox.addWidget(lbl)
        self.setLayout(hbox)
        self.move(300, 200)
        self.setWindowTitle('Red Rock')
        self.show()


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

程序预览：

七、行编辑

QLineEdit 组件提供了编辑文本的功能，自带了撤销、重做、剪切、粘贴、拖拽等功能

例子中展示了一个编辑组件和一个标签，我们在输入框里键入的文本， 会立即在标签里显示出来

代码实现：

import sys

from PyQt5.QtWidgets import (QWidget, QLabel,
                             QLineEdit, QApplication)


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

    def initUI(self):
        self.lbl = QLabel(self)
        # 创建一个 QLineEdit 对象
        qle = QLineEdit(self)
        qle.move(60, 100)
        self.lbl.move(60, 40)
        # 如果输入框的值有变化，就调用 onChanged() 方法
        qle.textChanged[str].connect(self.onChanged)

        self.setGeometry(300, 300, 280, 170)

        self.setWindowTitle('QLineEdit')
        self.show()

    # 在 onChanged() 方法内部，我们把文本框里的值赋值给了标签组件，
    # 然后调用 adjustSize() 方法让标签自适应文本内容
    def onChanged(self, text):
        self.lbl.setText(text)
        self.lbl.adjustSize()


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

程序预览：

八、QSplitter

QSplitter 组件能让用户通过拖拽分割线的方式改变子窗口大小的组 件。本例中我们展示用两个分割线隔开的三个 QFrame 组件

三个窗口和两个分割线的布局创建完成了，但是要注意，有些主题下， 分割线的显示效果不太好

代码实现：

import sys
from PyQt5.QtWidgets import (QWidget, QHBoxLayout, QFrame,
                             QSplitter, QStyleFactory, QApplication)

from PyQt5.QtCore import Qt


class Example(QWidget):
    def __init__(self):
        super().__init__()

        self.initUI()

    def initUI(self):
        hbox = QHBoxLayout(self)
        # 为了更清楚的看到分割线，
        # 我们使用了设置好的子窗口样式
        topleft = QFrame(self)
        topleft.setFrameShape(QFrame.StyledPanel)
        topright = QFrame(self)
        topright.setFrameShape(QFrame.StyledPanel)
        bottom = QFrame(self)
        bottom.setFrameShape(QFrame.StyledPanel)
        # 创建一个 QSplitter 组件,并在里面添加了两个框架
        splitter1 = QSplitter(Qt.Horizontal)
        splitter1.addWidget(topleft)
        splitter1.addWidget(topright)
        splitter2 = QSplitter(Qt.Vertical)
        # 也可以在分割线里面再进行分割
        splitter2.addWidget(splitter1)
        splitter2.addWidget(bottom)

        hbox.addWidget(splitter2)
        self.setLayout(hbox)
        self.setGeometry(300, 300, 300, 200)
        self.setWindowTitle('QSplitter')
        self.show()

    def onChanged(self, text):
        self.lbl.setText(text)
        self.lbl.adjustSize()


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

程序预览：

九、下拉选框

QComboBox 组件能让用户在多个选择项中选择一个

例子中包含了一个 QComboBox 和一个 QLabel 。下拉选择框有五个选项， 都是Linux的发行版名称，标签内容为选定的发行版名称

代码实现：

from PyQt5.QtWidgets import (QWidget, QLabel,
                             QComboBox, QApplication)
import sys


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

    def initUI(self):
        self.lbl = QLabel("Ubuntu", self)
        # 创建一个 QComboBox 组件和五个选项
        combo = QComboBox(self)
        combo.addItem("Ubuntu")
        combo.addItem("Mandriva")
        combo.addItem("Fedora")
        combo.addItem("Arch")
        combo.addItem("Gentoo")

        combo.move(50, 50)
        self.lbl.move(50, 150)
        # 在选中的条目上调用 onActivated() 方法
        combo.activated[str].connect(self.onActivated)

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

    # 在方法内部，设置标签内容为选定的字符串，
    # 然后设置自适应文本大小
    def onActivated(self, text):
        self.lbl.setText(text)
        self.lbl.adjustSize()


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

程序预览：