python图形开发GUI库pyqt5的详细使用方法及各控件的属性与方法

本文主要列出来python图形开发GUI库pyqt5的窗体,控件属性与方法如果你想看看python图形开发GUI库pyqt5的基础使用方法可以查看我们的另一篇文章 python图形开发GUI库pyqt5的基本使用方法详解

基本框架

import sys
from PyQt5.QtGui import *
from PyQt5.QtCore import *
from PyQt5.QtWidgets import *

class Demo(QWidget):     
  def __init__(self):
    super(Demo, self).__init__()
    # 设置主界面
    # 设置控件
    # 设置布局
    # 设置信号
	def main(self):
  	# 槽函数
if __name__ == '__main__':
  app = QApplication(sys.argv)
  demo = Demo()  
  demo.show()   
  sys.exit(app.exec_())

程序启动画面

if __name__ == '__main__':
	app = QApplication(sys.argv) # 原有

	splash = QSplashScreen()
	splash.setPixmap(QPixmap('images/splash.jpg'))
	splash.show()
	splash.showMessage('string', Qt.AlignBottom | Qt.AlignCenter, Qt.white)

	demo = Demo() # 原有
	demo.show() # 原有
	
	splash.finish(demo)

	sys.exit(app.exec_()) # 原有

一、设置主界面

self.setWindowTitle('title') # 设置窗体名称

self.setWindowIcon('path') # 设置窗体图标

self.resize(300, 250) # 更改窗体大小

self.size() # 获取窗体大小

self.width() # 获取窗体宽度

self.height() # 获取窗体高度

self.setFixedWidth(int width) # 设置窗体宽度

self.setFixedHeight(int height) # 设置窗体高度

self.setFixedSize(int width, int height) # 设置窗体大小

self.setGeometry(int x, int y, int width, int height) # 设置窗口位置

self.frameGeometry() # 获取窗口的大小和位置

self.move(int x, int y) # 设置窗口的位置

self.pos() # 获取窗口左上角坐标

self.setWindowFlags(QtCore.Qt.WindowMinimizeButtonHint) # 禁止最大化按钮

self.setFixedSize(self.width(), self.height()) # 禁止拉伸窗口大小

二、设置控件

1、QMessageBox消息框

1、基本格式

QMessageBox.information(QWidget, ‘Title', 'Content‘, buttons)

第一个参数填self，表示该信息框属于我们这里的Demo窗口；第二个参数类型为字符串，填入的是该信息框的标题；第三个参数类型也是字符串，填入的是信息框的提示内容；最后个参数为信息框上要添加的按钮。多个按钮之间用 | 来连接，常见的按钮种类有以下几种：

QMessageBox.Ok

QMessageBox.Yes

QMessageBox.No

QMessageBox.Close

QMessageBox.Cancel

QMessage.Open

QMessage.Save

2、各种类型的框

类型	名称
QMessageBox.information	消息框
QMessageBox.question	问答框
QMessageBox.warning	警告框
QMessageBox.critical	错误框
QMessageBox.about	关于框

3、与消息框进行交互

choice = QMessageBox.question(self, 'Title', 'Content', QMessageBox.Yes | QMessageBox.No) 
if choice == QMessageBox.Yes:  
  pass
elif choice == QMessageBox.No: 
	pass

2、文本编辑框和文本浏览框

实例化控件

self.text_edit = QTextEdit(self) # 文本编辑框

self.text_browser = QTextBrowser(self) # 文本浏览框

设置信号

控件类型	信号	描述
QTextEdit	textChanged	文本发生改变

控件方法

控件类型	方法	描述
QTextEdit	setText(‘Content')	设置文本
QTextEdit	toPlainText()	获取文本
QTextEdit	setTextColor(color)	设置文本颜色
QTextEdit	setFont(font)	设置字体

3、各种按钮

QPushButton，QToolButton，QRadioButton和QCheckBox均继承自QAbstractButton类

实例化控件

self.test_button = QPushButton('Test', self) # 实例化按钮

self.test_button = QPushButton('&Download'，self) # 实例化按钮并设置快捷键为Alt+D

self.test_button = QToolButton(self) # 工具按钮（初始不能传入文本）

self.on_button = QRadioButton('on', self) # 单选按钮

self.checkbox1 = QCheckBox('Checkbox 1', self) # 复选框的三种状态：全选中、半选中和无选中

设置信号

控件类型	信号	描述
通用	Pressed	当鼠标指针在按钮上并按下左键时触发该信号
通用	Released	当鼠标左键被释放时触发该信号
通用	Clicked	当鼠标左键被按下然后释放时，或者快捷键被释放时触发该信号
通用	Toggled	当按钮的标记状态发生改变时触发该信号
QCheckBox	stateChanged	复选框状态发生改变

控件方法

控件类型	方法	描述
通用	isDown()	提示按钮是否已按下
通用	isChecked()	提示按钮是否已经标记
通用	isEnable()	提示按钮是否可以被用户点击
通用	isCheckAble()	提示按钮是否为可标记的
通用	setAutoRepeat()	设置按钮是否在用户长按时可以自动重复执行
通用	setShortcut(‘Ctrl+D')	设置按钮快捷键
QPushButton	setCheckable(True)	设置按钮是否已经被选中，如果设置True，则表示按钮将保持已点击和释放状态
QPushButton	toggle()	在按钮状态之间进行切换
QPushButton	setIcon(QIcon(‘button.png'))	设置图标
QPushButton	setEnabled()	设置按钮是否可以使用，当设置为False时，按钮变成不可用状态，点击它不会发射信号
QPushButton	isChecked()	判断按钮是否为标记状态，若是则返回True，不是则返回False
QPushButton	setDefault()	设置按钮的默认状态
QPushButton	setText(‘text')	设置按钮的显示文本
QPushButton	text()	返回按钮的显示文本
QToolButton	setArrowType(参数1)	设定button上显示的箭头类型
QToolButton	setToolButtonStyle(参数2)	设定button文本和图标显示的样式
QRadioButton	setChecked(True)	单选按钮设为选中状态
QCheckBox	setChecked(True)	将复选框设为选中或无选中状态
QCheckBox	setCheckState(Qt.Checked)	选中状态Qt.Checked, 无选中状态Qt.Unchecked和半选中状态Qt.PartiallyChecked
QCheckBox	setTristate(True)	让一个复选框拥有三种状态
QCheckBox	setCheckState(Qt.PartiallyChecked)	让一个复选框拥有三种状态
QCheckBox	checkState()	获取当前复选框的状态，返回值为int类型，0为无选中状态，1为半选中状态，2为选中状态

参数1	箭头属性
Qt.NoArrow	无箭头
Qt.UpArrow	向上的箭头
Qt.DownArrow	向下的箭头
Qt.LeftArrow	向左的箭头
Qt.RightArrow	向右的箭头

参数2	样式
Qt.ToolButtonIconOnly	只显示图标
Qt.ToolButtonTextOnly	只显示文本
Qt.ToolButtonTextBesideIcon	文本在图标下面
Qt.ToolButtonTextUnderIcon	文本在图标上面
Qt.ToolButtonFollowStyle	未知…

4、标签

实例化控件

self.label = QLabel(self) 

控件方法

控件类型	方法	描述
QLabel	setPixmap(QPixmap(‘on.png'))	给标签设置图片
QLabel	setAlignment(Qt.AlignCenter)	设置标签对齐方式

5、单行文本框

实例化控件

self.lineedit = QLineEdit(self)

控件方法

控件类型	方法	描述
QLineEdit	setFont(combobox.currentFont())	设置字体
QLineEdit	setPlaceholderText()	设置文本框显示文字
QLineEdit	setMaxLength()	设置文本框所允许输入的最大字符数
QLineEdit	setReadOnly()	设置文本为只读
QLineEdit	setText()	设置文本框的内容
QLineEdit	text()	返回文本框的内容
QLineEdit	setDragEnable()	设置文本框是否接受拖动
QLineEdit	selectAll()	全选
QLineEdit	setFocus()	得到焦点
QLineEdit	setAlignment(参数1)	按固定值方式对齐文本
QLineEdit	setEchoMode(参数2)	设置文本框的显示格式
QLineEdit	setValidator(参数3)	设置文本框的验证器（验证规则），将限制任意可能输入的文本
QLineEdit	setInputMask(参数4)	设置掩码

参数1	功能
Qt.AlignLeft	水平方向靠左对齐
Qt.AlignRight	水平方向靠右对齐
Qt.AlignCenter	水平方向居中对齐
Qt.AlignJustify	水平方向调整间距两端对齐
Qt.AlignTop	垂直方向靠上对齐
Qt.AlignBottom	垂直方向靠下对齐
Qt.AlignVCenter	垂直方向居中对齐

参数2	功能
QLineEdit.Normal	正常显示所输入的字符，此为默认选项
QLineEdit.NoEcho	不显示任何输入的字符，常用于密码类型的输入，且长度保密
QLineEdit.Password	显示与平台相关的密码掩饰字符，而不是实际输入的字符
QLineEdit.PasswordEchoOnEdit	在编辑时显示字符，负责显示密码类型的输入

参数3	功能
QIntValidator	限制输入整数
QDoubleValidator	限制输入浮点数
QRegexpValidator	检查输入是否符合正则表达式

参数4	功能
000.000.000.000;_	ip地址，空白字符是‘_'
HH:HH:HH:HH:HH:HH;	MAC地址
0000-00-00	日期，空白字符是空格
>AAAAA-AAAAA-AAAAA-AAAAA-AAAAA;#	许可证号，空白字符是‘_'，所有字母都转换为大写

设置信号

控件类型	信号	描述
QLineEdit	selectionChanged	只要选择改变了，这个信号就会发射
QLineEdit	textChanged	当修改文本内容时，这个信号就会发射
QLineEdit	editingFinished	当编辑文本结束时，这个信号就会发射

6、下拉选择框和数字调节框

实例化控件

self.combobox_1 = QComboBox(self) # 普通下拉框（无内容）

self.combobox_2 = QFontComboBox(self) # 字体下拉框（有字体选择）

self.spinbox = QSpinBox(self) # 数字调节框（默认范围0-99）

self.doublespinbox = QDoubleSpinBox(self) # 浮点数字调节框（默认范围0.00-99.99）

设置信号

控件类型	信号	描述
QComboBox	currentIndexChanged	序号发生变化
QComboBox	currentTextChanged	文本发生变化
QSpinBox	valueChanged	数字发生变化

控件方法

控件类型	方法	描述
QComboBox	addItem(self.choice)	添加一个选项
QComboBox	addItems(self.choice_list)	添加多个选项
QComboBox	currentIndex()	获取当前文本序号
QComboBox	currentText()	获取当前文本
QComboBox	currentFont()	获取当前字体
QDoubleSpinBox	setDecimals(int)	设置小数位数
QSpinBox	setRange(-99, 99)	设置范围
QSpinBox	setSingleStep(1)	设置步长，即每次点击递增或递减多少值
QSpinBox	setValue(66)	设置初始显示值
QSpinBox	value()	获取值
QSpinBox	setValue(value)	设置调节框的值

7、滑动条和旋钮

实例化控件

self.slider_1 = QSlider(Qt.Horizontal, self) # 水平滑动条

self.slider_2 = QSlider(Qt.Vertical, self) # 垂直滑动条

self.dial = QDial(self) # 旋钮

设置信号

控件类型	信号	描述
QSlider	valueChanged	数值发生改变
QDial	valueChanged	改变表盘数值

控件方法

控件类型	方法	描述
QSlider	setRange(0, 100)	设置滑动条的范围
QSlider	setMinimum(0)	设置最小值
QSlider	setMaximum(100)	设置最大值
QSlider	value()	获取值
QSlider	setValue(value)	设置值
QDial	setFixedSize(100, 100)	固定旋钮的大小
QDial	setRange(0, 100)	设置表盘数值范围
QDial	setMinimum(0)	设置最小值
QDial	setMaximum(100)	设置最大值
QDial	setNotchesVisible(True)	显示刻度

8、定时器和进度条

实例化控件

控件类型	信号	描述
QTimer	timeout	timer.start()结束时触发

控件方法

控件类型	方法	描述
QTimer	isActive()	判断定时器是否处于激活状态
QTimer	start(100)	启动计时器持续100毫秒
QTimer	stop()	停止计时器
QTimer	setSingleShot(True)	触发timeout信号后只调用一次update_func()
QProgressBar	setMinimum(0)	设置最小值
QProgressBar	setMaximum(100)	设置最大值
QProgressBar	setRange(0, 100)	设置范围
QProgressBar	setValue(value)	设置进度条当前值
QProgressBar	reset()	重置进度条的值

9、数字显示屏

实例化控件

self.lcd = QLCDNumber(self) # 数字显示屏

控件方法

控件类型	方法	描述
QLCDNumber	setDigitCount(10)	设置显示多少位数字
QLCDNumber	display(1234567890)	显示数字
QLCDNumber	setSegmentStyle(参数1)	设置显示屏数字样式
QLCDNumber	setSmallDecimalPoint(True)	设置小数点的显示方式，若为True，则占位，若为False，则会单独占位
QLCDNumber	display(0.123456789)	显示数字
QLCDNumber	display(‘HELLO')	显示字母
QLCDNumber	setMode(参数2)	更改数字显示方式

参数1	值	描述
QLCDNumber.Outline	0	让内容浮显，其颜色同显示屏背景颜色相同
QLCDNumber.Filled	1	让内容浮显，颜色同窗口标题颜色相同
QLCDNumber.Flat	2	让内容扁平化显示，颜色同窗口标题颜色相同

参数2	值	描述
QLCDNumber.Hex	0	十六进制
QLCDNumber.Dec	1	十进制
QLCDNumber.Oct	2	八进制
QLCDNumber.Bin	3	二进制

三、设置布局

1、实例化布局

v_layout = QVBoxLayout() # 垂直布局

h_layout = QHBoxLayout() # 水平布局

form_layout = QFormLayout() # 表单布局

grid_layout = QGridLayout() # 网格布局

2、给布局添加占位符|控件|布局

self.label.setAlignment(Qt.AlignCenter) # 设置居中方式

h_layout.addStretch(1) # 设置占位符

v_layout.addWidget(self.user_label) # 垂直布局添加控件

h_layout.addWidget(self.user_line) # 水平布局添加控件

all_v_layout.addLayout(v_layout) # 垂直布局添加垂直布局

all_h_layout.addLayout(h_layout) # 水平布局添加水平布局

form_layout.addRow(self.user_label, self.user_line) # 表单布局添加控件

grid_layout.addWidget(self.user_label, 0, 0, 1, 1) # 网格布局添加控件

grid_layout.addWidget(self.user_label, 0, 0) # 默认是1行1列

QGridLayout的addWidget()方法遵循如下语法形式：

addWidget(widget, row, column, rowSpan, columnSpan)

widget就是要添加的控件；row为第几行，0代表第一行；column为第几列，0代表第一列；rowSpan表示要让这个控件去占用几行(默认一行)；columnSpan表示要让这个控件去占用几列(默认一列)。

3、设为整个窗口的最终布局方式

self.setLayout(all_h_layout)

四、各种对话框

1、颜色对话框和字体对话框

color = QColorDialog.getColor() # 颜色对话框（十六进制的值会保存在color变量中）
if color.isValid(): # 判断color是否有效
	self.text_edit.setTextColor(color)

font, ok = QFontDialog.getFont() # 字体对话框
if ok:
	self.text_edit.setFont(font)

2、输入对话框

方法	用法
getItem()	从下拉框中获取选项输入
getInt()	获取整型值输入
getDouble()	获取浮点型值输入
getText()	获取字符串输入
getMultiLineText()	获取多行字符串输入

实例：

content, ok = QInputDialog.getText(self, 'title', 'content')

content, ok = QInputDialog.getInt(self, 'title', 'content')

content, ok = QInputDialog.getDouble(self, 'title', 'content')

content, ok = QInputDialog.getMultiLineText(self, 'title', 'content')

Item, ok = QInputDialog.getItem(self, 'title', 'content', list, 0, False)

getItem(parent, str, str, iterable, int, bool)方法需要多设置几个参数，前三个与getText()相同，第四个参数为要加入的选项内容，第五个参数为最初显示的选项，最后一个参数是选项内容是否可编辑。

3、文件对话框

path, _ = QFileDialog.getSaveFileName(self, 'title', './', 'Excel Files (*.xlsx;*.xls);;All Files (*)') # 选择保存文件

path, _ = QFileDialog.getOpenFileName(self, 'title', './', 'Excel Files (*.xlsx;*.xls);;All Files (*)') # 选择文件

path, _ = QFileDialog.getOpenFileNames(self, 'title', './', 'Excel Files (*.xlsx;*.xls);;All Files (*)') # 选择多个文件

path, _ = QFileDialog.getExistingDirectory(self, 'title', './') # 选择文件夹

参数：指定父类，文件对话框的标题，对话框打开时显示的路径，文件扩展名过滤器

其中设置文件扩展名过滤，用双分号间隔。

'All Files (*);;PDF Files (*.pdf);;Text Files (*.txt)'

五、界面关闭事件

def closeEvent(self, QCloseEvent): # 关闭事件函数
	if not self.saved: # 如果未保存
		choice = QMessageBox.question(self, '', 'Do you want to save the text?', QMessageBox.Yes | QMessageBox.No | QMessageBox.Cancel)
		if choice == QMessageBox.Yes: # 如果需要继续保存
			self.saved_func()	# 调用函数进行保存
			QCloseEvent.accept()	# 接受关闭事件
		elif choice == QMessageBox.No: # 如果不需要继续保存
			QCloseEvent.accept()	# 接受关闭事件
		else:
  		QCloseEvent.ignore()	# 忽略关闭事件

更多关于python图形开发GUI库pyqt5的使用方法请查看下面的相关链接