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