PyQt5学习笔记(4)控件

参考:PyQt5 教程, 该文档翻译自PyQt5 tutorial

PyQt5 控件

控件是构建应用程序的基本模块,PyQt5 提供各种各样的控件,包括按钮、复选框、滑动条、列表框等。

1.QCheckBox

QCheckBox 复选框控件,它有两个状态: 打开和关闭,他是一个带有文本标签(Label)的控件。复选框常用于表示程序中可以启用或禁用的功能。

示例 23:

# -*- coding: utf-8 -*-

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


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 信号。# 这个方法会切换窗体的标题。cb.stateChanged.connect(self.changeTitle)

        self.setGeometry(300, 300, 500, 400)
        self.setWindowTitle('QCheckBox')
        self.show()


    def changeTitle(self, state):
        # 复选框的状态经由 state 参数传入 changeTitle()方法。# 在勾选复选框时设置窗体标题,取消勾选时就将标题设为空字符串。if state == Qt.Checked:
            self.setWindowTitle('QCheckBox')
        else:
            self.setWindowTitle('')


if __name__ == '__main__':

    app = QApplication(sys.argv)
    ex = Example()
    sys.exit(app.exec_())

2. 开关按钮 Toggle button

ToggleButton 是 QPushButton 的一种特殊模式。它是一个有两种状态的按钮:按下与未按下。通过点击在这两种状态间来回切换。这种功能在某些场景会很实用。

示例 24:

# -*- coding: utf-8 -*-

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


class Example(QWidget):

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

        self.initUI()


    def initUI(self):      
        # 初始黑颜色的值
        self.col = QColor(0, 0, 0)       

        # 创建三个 ToggleButton
        # ToggleButton 会切换颜色值中的红色、绿色与蓝色部分
        redb = QPushButton('Red', self)
        redb.setCheckable(True)
        redb.move(10, 10)

        redb.clicked[bool].connect(self.setColor)

        # 创建一个 QPushButton
        # 并通过其 setCheckable()方法来得到一个 ToggleButton
        greenb = QPushButton('Green', self)
        greenb.setCheckable(True)
        greenb.move(10, 60)

        # 将 clicked 信号连接到用户自定义的方法。# 我们通过 clicked 信号操作一个布尔值。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

        if source.text() == "Red":
            # 如果按下的是 red 按钮,我们要相应地更新颜色中的红包部分。# 即:QColor(0, 0, 0)  中的红色部分设置为 255
            self.col.setRed(val)                
        elif source.text() == "Green":
            self.col.setGreen(val)             
        else:
            self.col.setBlue(val) 

        self.square.setStyleSheet("QFrame { background-color: %s}" %
            self.col.name())  


if __name__ == '__main__':

    app = QApplication(sys.argv)
    ex = Example()
    sys.exit(app.exec_())

3. 滑动条 QSlider

QSlider 是一个带有简单滑块的控件。滑块可以前后拖动。我们可以通过拖动选择一个特定的值。有时使用滑动条比直接输入数字或使用旋转框更加自然。

在下面的例子中,我们会显示一个滑动条与一个标签,标签用于显示图片,并通过滑动条控件图片的显示。

注意这里图片只能用 ico 格式的,png 格式图片会显示不了。

示例 25:

# -*- coding: utf-8 -*-

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


class Example(QWidget):

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

        self.initUI()


    def initUI(self):      

        # 创建一个水平滑块
        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('audio.ico'))
        self.label.setGeometry(160, 40, 250, 250)

        self.setGeometry(300, 300, 500, 500)
        self.setWindowTitle('QSlider')
        self.show()


    def changeValue(self, value):
        # ico 下载:https://www.iconarchive.com/tag/audio
        # 我们根据滑动条的值来设置标签的图像
        if value == 0:
            self.label.setPixmap(QPixmap('audio.ico'))
        elif value > 0 and value <= 30:
            self.label.setPixmap(QPixmap('min.ico'))
        elif value > 30 and value < 80:
            self.label.setPixmap(QPixmap('med.ico'))
        else:
            self.label.setPixmap(QPixmap('max.ico'))


if __name__ == '__main__':

    app = QApplication(sys.argv)
    ex = Example()
    sys.exit(app.exec_())    

4. 进度条 QProgressBar

一个进度条是一个显示任务进展的控件。QProgressBar 控件提供了一个水平或垂直 PyQt5 工具包的进度条。程序员可以设置进度条的最小和最大值。默认值是 0 到 99。

每个 QObject 及其子类都有一个 timerEvent()事件处理器。我们要重新实现这个事件处理器来响应定时器事件。

示例 26:

# -*- coding: utf-8 -*-

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


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)

        # 使用定时器 timer 来激活 QProgressBar
        self.timer = QBasicTimer()
        self.step = 0

        self.setGeometry(300, 300, 280, 170)
        self.setWindowTitle('QProgressBar')
        self.show()

    def timerEvent(self, e):
        # 每个 QObject 及其子类都有一个 timerEvent()事件处理器。# 我们要重新实现这个事件处理器来响应定时器事件。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):
        # 在 doAction()方法中启动 / 停止定时器
        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_())

5. 日历控件 QCalendarWidget

QCalendarWidget 提供了一个基于月份的日历控件。它使用户以一种简单直观的方式来选择日期。

示例中创建了一个日历控件和一个标签控件。选择的日期会显示在标签控件中。

示例 27:

# -*- coding: utf-8 -*-

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


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

        self.initUI()

    def initUI(self):
        cal = QCalendarWidget(self)
        cal.setGridVisible(True)
        cal.move(20, 20)
        # 如果我们从部件选择一个日期, 点击 [QDate] 发出信号。# 我们将这个信号连接到用户定义的 showDate()方法。cal.clicked[QDate].connect(self.showDate)

        self.lbl = QLabel(self)
        date = cal.selectedDate()
        self.lbl.setText(date.toString())
        self.lbl.move(130, 260)

        self.setGeometry(300, 300, 500, 500)
        self.setWindowTitle('Calendar')
        self.show()

    def showDate(self, date):
        # 我们检索所选日期通过调用 selectedDate()方法。# 然后我们将 date 对象转换为字符串, 并将其设置为小部件的标签。self.lbl.setText(date.toString())


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

6.QPixmap

QPixmap 是用于处理图像的控件。是优化的显示图像在屏幕上。在我们的代码示例中, 我们将使用 QPixmap 窗口显示一个图像。

示例 28:

# -*- coding: utf-8 -*-

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


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

        self.initUI()

    def initUI(self):
        hbox = QHBoxLayout(self)
        # 创建一个 QPixmap 对象,它将传入的文件名作为参数。pixmap = QPixmap("qt.png")

        self.lbl = QLabel(self)
        # 将这个 pixmap 放到 QLabel 控件中
        self.lbl.setPixmap(pixmap)
        self.lbl.move(200, 200)

        hbox.addWidget(self.lbl)
        self.setLayout(hbox)

        self.setGeometry(300, 300, 500, 500)
        self.move(300, 200)
        self.setWindowTitle('Qt')
        self.show()


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

7. 文本框 QLineEdit

QLineEdit 是用于输入或编辑单行文本的控件。它还有撤销重做、剪切复制和拖拽功能。

示例中展示了一个 QLineEdit 与一个 QLabel。我们在 QLineEdit 中输入的文字会实时显示在 QLabel 控件中。

示例 29:

# -*- coding: utf-8 -*-

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)
        qle = QLineEdit(self)

        qle.move(60, 100)
        self.lbl.move(60, 40)

        qle.textChanged[str].connect(self.onChanged)

        self.setGeometry(300, 300, 280, 170)
        self.setWindowTitle('QLineEdit')
        self.show()

    def onChanged(self, text):
        # 在 onChanged()方法中我们将 QLabel 控件的文本设置为输入的内容。# 通过调用 adjustSize()方法将 QLabel 控件的尺寸调整为文本的长度。self.lbl.setText(text)
        self.lbl.adjustSize()


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

8.QSplitter

通过 QSplitter,用户可以拖动子控件边界来调整子控件的尺寸。

在下面的示例中,我们展示了三个由两个 QSplitter 组织的 QFrame 控件。

示例 30:

# -*- coding: utf-8 -*-

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


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

        self.initUI()

    def initUI(self):
        hbox = QHBoxLayout(self)

        # 创建了三个 QFrame
        topleft = QFrame(self)
        # 设置 shape, 否则看不到 QFrame 小部件
        topleft.setFrameShape(QFrame.StyledPanel)

        topright = QFrame(self)
        topright.setFrameShape(QFrame.StyledPanel)

        bottom = QFrame(self)
        bottom.setFrameShape(QFrame.StyledPanel)

        # 创建两个 QSplitter。# 注意在某些主题中这些 QSplitter 可能会不可见。splitter1 = QSplitter(Qt.Horizontal)
        # 由 QSplitter 组织 QFrame 控件
        splitter1.addWidget(topleft)
        splitter1.addWidget(topright)

        splitter2 = QSplitter(Qt.Vertical)
        # 由 QSplitter 组织 QFrame 控件
        splitter2.addWidget(splitter1)
        splitter2.addWidget(bottom)

        hbox.addWidget(splitter2)
        self.setLayout(hbox)

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


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

左右栏示例:

# -*- coding: utf-8 -*-

import sys
from PyQt5.QtWidgets import (QWidget, QHBoxLayout, QLabel,                           
                             QSplitter, QApplication)
from PyQt5.QtCore import Qt,QUrl
from PyQt5.QtWebEngineWidgets import  QWebEngineView

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

        self.initUI()

    def initUI(self):
        hbox = QHBoxLayout(self)

        # 左侧空间
        lbl1 = QLabel('Zetcode', self)
        lbl2 = QLabel('tutorials', self)
        lbl3 = QLabel('for programmers', self)

        # 右侧空间
        browser = QWebEngineView(self)
        browser.load(QUrl("https://www.baidu.com"))

        # 创建两个 QSplitter。splitter1 = QSplitter(Qt.Vertical)
        splitter1.addWidget(lbl1)
        splitter1.addWidget(lbl2)
        splitter1.addWidget(lbl3)

        # splitter1 是 splitter2 的 child
        # 使用 setSizes 固定左侧的初始宽度
        splitter2 = QSplitter(Qt.Horizontal)
        splitter2.addWidget(splitter1)
        splitter2.addWidget(browser)

        splitter2.setSizes([200,2000])

        hbox.addWidget(splitter2)

        self.setLayout(hbox)

        self.setGeometry(200, 200, 2000, 1500)
        self.setWindowTitle('QSplitter')
        self.show()


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

效果:

9. 下拉列表 QComboBox

QComboBox 是允许用户从下拉列表中进行选择的控件。

示例中展示了一个 QComboBox 与一个 QLabel,QComboBox 控件中有 5 个选项(Linux 系统的几个发行版名称)。QLabel 控件会显示 QComboBox 中选中的某个选项。

示例 31:

# -*- coding: utf-8 -*-

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


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):
        # 在方法中我们将 QLabel 控件的内容设置为选中的条目,然后调整它的尺寸。self.lbl.setText(text)
        self.lbl.adjustSize()


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