PyQt5基础控件

QLabel标签

功能：在界面上显示文字、图片、链接等

接口：

方法	描述
setText()	设置显示的内容
setAlignment()	设置文字对齐方式
setToolTip()	设置提示信息
setPixmap()	设置显示内容为图片
setOpenExternalLinks()	允许访问链接，打开浏览器，默认非使能

信号：

信号	描述
linkActivated	点击标签中的超链接，且setOpenExternalLinks为true时触发
linkHovered	当鼠标滑过标签中的超链接时触发

QLineEdit

功能：单行文本输入框

接口：

方法	描述
setAlignment()	设置内容对齐方式
clear()	清空
setPlaceholderText()	显示默认内容
setMaxLength()	设置运行输入的最大长度
setReadOnly()	设置内容只读
setText()	设置文本框内容
Text()	返回文本框内容
selectAll()	全选
setFocus()	获取焦点
setEchoMode()	设置显示的内容格式： QLineEdit.Normal：正常显示所有字符，默认选项 QLineEdit.NoEcho：不显示任何字符 QLineEdit.Password：显示与平台相关的掩码字符，不显示实际输入内容 QLineEdit.PasswordEchoOnEdit：在编辑时显示字符
setInputMask()	设置掩码
setValidator()	设置允许输入的内容： QIntValidator：限制输入整型 QDoubleValidator：限制输入浮点数 QRegexpValidator：限制输入符合正则表达式

信号：

信号	描述
selectionChanged	选中的内容改变时触发
textChanged	修改文本内容时触发
editingFinished	文本编辑结束时触发

QTextEdit

功能：显示多行文本、html文档

接口：

方法	描述
setPlainText()	设置多行文本框内容
toPlainText()	返回多行文本框内容
setHtml()	设置内容为html文档
toHtml()	返回多行文本框内容
clear()	清空

信号：与单行文本框类似

QAbstractButton

功能：按钮的公共基础类，不能直接实例化，主要提供按钮的通用功能

状态：按钮具有几种状态，可以相互切换

状态	含义
isDown()	按钮是否被按下
isChecked()	按钮是否被标记
isEnable()	按钮是否可以被用户点击
isCheckAble()	按钮是否可被标记
setAutoRepeat()	按钮在用户长按时，是否可以自动重复执行

信号：

信号	描述
Pressed	按钮被按下时触发
Released	按钮被弹起时触发
Clicked	按钮被按下且弹起时触发
Toggled	按钮标记状态改变时触发

QPushButton

功能：单击按钮

接口：

方法	描述
setCheckable()	设置按钮是否被选中。true或false。
toggle()	在按钮状态之间切换
setIcon()	设置按钮图标
setEnable()	设置按钮是否可用。true或false。
isChecked()	返回按钮的选中状态
setText()	设置按钮显示文本
text()	获取显示文本

QRadioButton

功能：单选按钮，提供多选一的功能

说明：继承之同一个父类的单选按钮，默认多个单选按钮属于同一组；如果要实现多组，需要使用QGroupBox或QButtonGroup

接口：

方法	描述
setCheckAble()	设置按钮是否被选中
isChecked()	返回按钮的状态
setText()	设置显示文本
text()	返回显示文本

QCheckBox

功能：复选框，提供多选多的功能

接口：

方法	描述
setChecked	设置复选框状态
setText	设置显示文本
text	返回显示文本
isChecked	检查复选框是否被选中

QComboBox

功能：下拉框

接口：

方法	描述
addItem()	添加一个下拉选项
addItems()	从列表中添加下拉选项
clear()	清空
count()	返回下拉选项的数目
currentText()	返回选中选项的文本
itemText(i)	获取索引为i的选项文本
currentIndex()	返回选中的索引
setItemText(index, text)	设置索引i的内容为text

QSpinBox/QDoubleSpinBox

功能：计数器，允许用户选中一个值（整型或浮点型）

接口：

方法	描述
setMinimum()	设置计数器的最小值
setMaximum()	设置计数器的最大值
setRange()	设置计数器的最大值、最小值以及步长
setValue()	设置计数器的当前值
Value()	获取计数器的当前值
setSingleStep()	设置计数器步长

信号：

信号	描述
valueChanged	计数器值改变时触发

QProgressBar

功能：进度条

接口：

方法	描述
setRange()	设置范围
setMinimum()	设置下限
setMaximum()	设置上限
setValue()	设置进度条的值
reset()	进度条复位

QSlider

功能：滑动条，通过滑动的方式选择值，比计数器更加方便自然

接口：

方法	描述
setMinimum()	设置滑动条最小值
setMaximum()	设置滑动条最大值
singleStep()	设置步长
setValue()	设置滑动条当前值
Value()	获取当前值
setTickInterval()	设置刻度间隔
setTickPosition()	设置刻度的样式 QSlider.NoTicks：不绘制刻度 QSlider.TicksBothSides：在滑块的两侧绘制刻度 QSlider.TicksAbove：在滑块上方绘制刻度线 QSlider.TicksBelow：在滑块下方绘制刻度线 QSlider.TicksLeft：在滑块左侧绘制刻度线 QSlider.TicksRight：在滑块右侧绘制刻度线

信号：

信号	描述
valueChanged	当滑块的值发生变化时触发
sliderPressed	当滑块被按下时触发
sliderMoved	当滑块被拖动时触发
sliderReleased	当滑块弹起时时触发

QCalendar

功能：日历控件

接口：

方法	描述
setDateRange()	设置可供选择的日期范围
setFirstDayofWeek()	设置星期的第一天，默认是星期天
setMinimumDate()	设置最大日期
setMaxmumDate()	设置最小日期
setSelectDate()	设置一个QData对象，作为当前日期空间所选定的日期
maximumDate()	获取最大日期
minimumDate()	获取最小日期
selectedData()	获取当前选定的日期
setGridvisible()	设置容器空间是否显示网格

信号：

信号	描述
clicked(QtCore.QDate)	选定一个日期时触发

QDateTimeEdit

功能：允许用户编辑日期时间的控件，可以使用键盘和上下箭头来增加和减少日期的时间值

接口：

方法	描述
setDisplayFormat()	设置日期时间格式： yyyy：年 MM：月 dd：日 HH：小时 mm：分钟 ss：秒
setMinimumDate()	设置最小日期
setMaxmumDate()	设置最大日期
time()	返回编辑的时间
date()	返回编辑的日期

信号：

信号	描述
dateChanged	日期改变时触发
dateTimeChanged	日期或时间改变时都会触发（优先）
timeChanged	时间改变时触发

例子

1.将QLineEdit输入的内容显示到QLabel上

import sys
 
from PyQt5.QtCore import Qt
from PyQt5.QtGui import QPalette
from PyQt5.QtWidgets import QApplication, QWidget, QLabel, QLineEdit
 
class MyWidget(QWidget):
    def __init__(self):
        super(MyWidget, self).__init__()
        # 初始化label
        self.label = QLabel(self)
        self.label.resize(100, 20)
        self.label.move(10, 10)
        self.label.setAutoFillBackground(True)
        self.palette = QPalette()
        self.palette.setColor(QPalette.Window, Qt.green)
        self.label.setPalette(self.palette)
        # 初始化lineEdit
        self.lineEdit = QLineEdit(self)
        self.lineEdit.setPlaceholderText('please enter')
        self.lineEdit.resize(100, 20)
        self.lineEdit.move(10, 40)
        # 绑定textChanged到方法
        self.lineEdit.textChanged.connect(self.syncToLabel)
 
    # 将lineEdit输入的内容显示到标签上
    def syncToLabel(self, msg):
        self.label.setText(msg)
 
if __name__ == '__main__':
    app = QApplication(sys.argv)
    w = MyWidget()
    w.resize(500, 300)
    w.move(300, 300)
    w.setWindowTitle('Simple')
    w.show()
    sys.exit(app.exec_())

2.多种按钮

import sys
 
from PyQt5.QtWidgets import QApplication, QWidget, QPushButton, QCheckBox, QRadioButton, QGroupBox, QVBoxLayout, \
    QHBoxLayout
 
class MyWidget(QWidget):
    def __init__(self):
        super(MyWidget, self).__init__()
        # button
        self.button = QPushButton(self)
        self.button.move(10, 10)
        self.button.setText('按钮')
        self.button.clicked.connect(self.onButtonClicked)
 
        # radio
        self.radio1 = QRadioButton("Radio button 1")
        self.radio2 = QRadioButton("Radio button 2")
        self.radio3 = QRadioButton("Radio button 3")
 
        vbox = QVBoxLayout()
        vbox.addWidget(self.radio1)
        vbox.addWidget(self.radio2)
        vbox.addWidget(self.radio3)
        vbox.addStretch(1)
 
        radioGroup = QGroupBox(self)
        radioGroup.setLayout(vbox)
        radioGroup.move(10, 50)
 
        self.radio1.clicked.connect(self.onRadioClicked)
        self.radio2.clicked.connect(self.onRadioClicked)
        self.radio3.clicked.connect(self.onRadioClicked)
 
        # checkBox
        self.checkBox1 = QCheckBox("check box 1")
        self.checkBox2 = QCheckBox("check box 2")
        self.checkBox3 = QCheckBox("check box 3")
 
        hbox = QHBoxLayout()
        hbox.addWidget(self.checkBox1)
        hbox.addWidget(self.checkBox2)
        hbox.addWidget(self.checkBox3)
        hbox.addStretch(1)
 
        checkGroup = QGroupBox(self)
        checkGroup.setLayout(hbox)
        checkGroup.move(10, 150)
 
        self.checkBox1.stateChanged.connect(lambda: self.onCheckClicked(self.checkBox1))
        self.checkBox2.stateChanged.connect(lambda: self.onCheckClicked(self.checkBox2))
        self.checkBox3.stateChanged.connect(lambda: self.onCheckClicked(self.checkBox3))
 
    def onButtonClicked(self):
        print('button clicked')
 
    def onRadioClicked(self):
        print('radio clicked')
        if self.radio1.isChecked():
            print('radio1 checked')
        elif self.radio2.isChecked():
            print('radio2 checked')
        elif self.radio3.isChecked():
            print('radio3 checked')
 
    def onCheckClicked(self, checkBox):
        print('check clicked')
        print(checkBox.text())
 
if __name__ == '__main__':
    app = QApplication(sys.argv)
    w = MyWidget()
    w.resize(500, 300)
    w.move(300, 300)
    w.setWindowTitle('Simple')
    w.show()
    sys.exit(app.exec_())

3.通过点击设置值

import sys
 
from PyQt5.QtCore import Qt
from PyQt5.QtGui import QFont
from PyQt5.QtWidgets import QApplication, QWidget, QComboBox, QSpinBox, QSlider
 
class MyWidget(QWidget):
    def __init__(self):
        super(MyWidget, self).__init__()
        # comboBox
        self.com = QComboBox(self)
        self.com.move(10, 10)
        self.com.addItem('one')
        self.com.addItem('two')
        self.com.addItem('three')
        self.com.currentIndexChanged.connect(self.onChange)
 
        # spinBox
        self.spin = QSpinBox(self)
        self.spin.resize(100, 30)
        self.spin.move(10, 50)
        self.spin.setRange(10, 50)
        self.spin.setSingleStep(2)
        self.spin.setValue(25)
        self.spin.valueChanged.connect(self.onSpinChange)
 
        # slider
        self.slider = QSlider(Qt.Horizontal)
        self.slider.setParent(self)
        self.slider.resize(300, 20)
        self.slider.move(10, 100)
        self.slider.setRange(50, 150)
        self.slider.setTickInterval(5)
        self.slider.setValue(50)
        self.slider.setTickPosition(QSlider.TicksBelow)
        self.slider.setFont(QFont('Arial', 18))
        self.slider.valueChanged.connect(self.onSliderChange)
 
    def onChange(self, index):
        print(self.com.itemText(index))
 
    def onSpinChange(self, value):
        print(value)
 
    def onSliderChange(self, value):
        print(value)
 
if __name__ == '__main__':
    app = QApplication(sys.argv)
    w = MyWidget()
    w.resize(500, 300)
    w.move(300, 300)
    w.setWindowTitle('Simple')
    w.show()
    sys.exit(app.exec_())

4.日期时间选择

import sys
from PyQt5 import QtCore
from PyQt5.QtCore import QDate, Qt
from PyQt5.QtWidgets import QApplication, QWidget, QCalendarWidget, QDateTimeEdit
 
class MyWidget(QWidget):
    def __init__(self):
        super(MyWidget, self).__init__()
 
        # 日历
        self.calendar = QCalendarWidget(self)
        self.calendar.setMinimumDate(QDate(1980, 1, 1))
        self.calendar.setMaximumDate(QDate(3000, 1, 1))
        self.calendar.setGridVisible(True)
        self.calendar.setFirstDayOfWeek(Qt.Monday)
        self.calendar.move(10, 10)
        self.calendar.clicked[QtCore.QDate].connect(self.showData)
 
        # dateTimeEdit
        self.dte = QDateTimeEdit(self)
        self.dte.setMaximumDate(QDate.currentDate().addDays(365))
        self.dte.setMinimumDate(QDate.currentDate().addDays(-365))
        self.dte.setDisplayFormat('yyyy-MM-dd HH:mm:ss')
        self.dte.move(10, 250)
        self.dte.dateChanged.connect(self.onDateChange)
        self.dte.timeChanged.connect(self.onTimeChange)
        self.dte.dateTimeChanged.connect(self.onDateTimeChange)
 
    def showData(self, date):
        print(date.toString("yyyy-MM-dd dddd"))
 
    def onDateChange(self, data):
        print("onDateChange: ")
        print(data)
 
    def onTimeChange(self, time):
        print("onTimeChange: ")
        print(time)
 
    def onDateTimeChange(self, dateTime):
        print("onDateTimeChange: ")
        print(dateTime)
 
if __name__ == '__main__':
    app = QApplication(sys.argv)
    w = MyWidget()
    w.resize(500, 300)
    w.move(300, 300)
    w.setWindowTitle('Simple')
    w.show()
    sys.exit(app.exec_())

setRange