Sorry, your browser cannot access this site
This page requires browser support (enable) JavaScript
Learn more >
QT 官方文档,

一、基本功能

1.1、建立简单的窗口

import sys
from PyQt5.QtGui import QIcon
from PyQt5.QtWidgets import QApplication, QWidget
if __name__ == '__main__':
app = QApplication(sys.argv)
w = QWidget()
w.resize(250, 150)
w.move(300, 300)
w.setWindowTitle('Simple')
w.setGeometry(300, 300, 300, 220)
w.setWindowIcon(QIcon('pyqt使用方法/pic/提示.png'))
w.show()
sys.exit(app.exec_())

示例窗口

app = QApplication(sys.argv):
每个PyQt5应用都必须创建一个应用对象。sys.argv是一组命令行参数的列表。Python可以在shell里运行,这个参数提供对脚本控制的功能。
w = QWidget():
QWidge控件是一个用户界面的基本控件,它提供了基本的应用构造器。默认情况下,构造器是没有父级的,没有父级的构造器被称为窗口(window)
w.resize(250, 150):
resize()方法能改变控件的大小,这里的意思是窗口宽250px,高150px
w.move(300, 300):
move()是修改控件位置的的方法。它把控件放置到屏幕坐标的(300, 300)的位置。注:屏幕坐标系的原点是屏幕的左上角
w.setGeometry(300, 300, 300, 220):
把窗口放到屏幕上并且设置窗口大小。参数分别代表屏幕坐标的x、y和窗口大小的宽、高(是resize和move的集合体)
w.setWindowTitle('Simple'):
给窗口添加了一个标题,标题在标题栏展示
w.show():
show()能让控件在桌面上显示出来。控件在内存里创建,之后才能在显示器上显示出来
sys.exit(app.exec_()):
当调用exit()方法或直接销毁主控件时,主循环就会结束。sys.exit()方法能确保主循环安全退出

1.2、控件

1.2.1、按钮

创建按钮:第一个参数是按钮的文本,第二个参数是按钮的父级组件:
qbtn = QPushButton('按钮', self)
按钮绑定事件:
qbtn.clicked.connect(function)
给按钮添加提示语:
QToolTip.setFont(QFont('SansSerif', 10))
qbtn.setToolTip('This is a <b>QPushButton</b> widget')

QPushButton 按钮控件,

1.2.2、图像控件 QPixmap

创建一个QPixmap 对象,它将传入的文件名作为参数:
pixmap = QPixmap("icon.png")
将pixmap放到QLabel控件中:
lbl = QLabel(self)
lbl.setPixmap(pixmap)

1.2.3、文本框 QLineEdit

创建一个QLineEdit对象:
qle = QLineEdit(self)

文本的设置与获取

API 含义
setText() 插入文本
text() 获取文本内容
displayText() 获取文本显示的内容

显示模式

API 含义
setEchoMode(QLineEdit_EchoMode) 设置显示模式
echoMode() 获取文本框输入模式
QLineEdit_EchoMode 含义
Normal 普通模式,显示输入的值
NoEcho 不输出
Password 密文显示,显示都是星号
PasswordEchoOnEdit 输入时候显示,结束后密文

输入限制

相关API 含义
setMaxLength(int) 这是最大长度
maxLength() 获取最长度
setReadOnly(bool) 设置只读
isReadOnly() 获取是否只读
setValidator(QValidator) 设置验证器
setInputMask(mask_str) 掩码验证
hasAcceptableInput() 文本是否通过验证

文本框的编辑状态

相关API 含义
isModified(bool) 是否被编辑
setModified() 设置编辑状态
QLineEdit 单行文本输入,

二、布局管理

2.1、水平布局

水平对齐

layout = QHBoxLayout()
layout.addWidget(QPushButton(str(1))
layout.addWidget(QPushButton(str(2))

水平居中对齐

layout = QHBoxLayout()
layout.addStretch(1) # 前面增加一行
layout.addWidget(QPushButton(str(1))
layout.addWidget(QPushButton(str(2))
layout.addStretch(1) #后面增加一行

水平两端对齐

layout = QHBoxLayout()
layout.addWidget(QPushButton(str(1))
layout.addStretch(1)  # 添加行
layout.addWidget(QPushButton(str(2))

布局对齐方式

参数 描述
QtCore.Qt.AlignLeft 水平方向居左对齐
QtCore.Qt.AlignRight 水平方向居右对齐
QtCore.Qt.AlignCenter 水平方向居中对齐
QtCore.Qt.AlignJustify 水平方向两端对齐
QtCore.Qt.AlignTop 垂直方向靠上对齐
QtCore.Qt.AlignBottom 垂直方向靠下对齐
QtCore.Qt.AlignVCenter 垂直方向居中对齐

2.2、垂直布局

垂直对齐

layout = QVBoxLayout()
layout.addWidget(QPushButton(str(1))
layout.addWidget(QPushButton(str(2))

垂直顶部对齐

layout = QVBoxLayout()
layout.addWidget(QPushButton(str(1))
layout.addWidget(QPushButton(str(2))
layout.addStretch(1)  # 添加行

垂直底部对齐

layout = QVBoxLayout()
layout.addStretch(1)  # 添加行
layout.addWidget(QPushButton(str(1))
layout.addWidget(QPushButton(str(2))

垂直居中对齐

layout = QVBoxLayout()
layout.addStretch(1)  # 添加行
layout.addWidget(QPushButton(str(1))
layout.addWidget(QPushButton(str(2))
layout.addStretch(1)  # 添加行

垂直两端对齐

layout = QVBoxLayout()
layout.addWidget(QPushButton(str(1))
layout.addStretch(1)  # 添加行
layout.addWidget(QPushButton(str(2))

增加两个控件的距离(两个按钮之间的距离):

layout = QHBoxLayout()
layout.addWidget(QPushButton(str(1))
layout.addSpacing(100)
layout.addWidget(QPushButton(str(2))
QT 布局管理,

三、对话框

常用方法

方法 描述
information(QWidget parent,title,text,buttons,defaultButton) 弹出消息对话框,参数解释:parent(指定的父窗口控件),title(对话框标题),text(对话框文本),buttons(多个标准按钮,默认设为OK按钮),defaultButton(默认选中的标准按钮,默认是第一个标准按钮)
question(QWidget parent,title,text,buttons,defaultButton) 弹出问答对话框
warning(QWidget parent,title,text,buttons,defaultButton) 弹出警告对话框
critical(QWidget parent,title,text,buttons,defaultButton) 弹出严重错误对话框
about(QWidget parent,title,text) 弹出关于对话框
setTitle() 设置标题
setText() 设置消息正文
setIcon() 设置弹出对话框的图片

标准按钮类型

类型 描述
QMessage.OK 同意操作
QMessage.Cancel 取消操作
QMessage.Yes 同意操作
QMessage.No 取消操作
QMessage.Abort 终止操作
QMessage.Retry 重试操作
QMessage.Ignore 忽略操作

创建对话框:
reply = QMessageBox.information(self,"消息对话框","消息对话框正文",QMessageBox.Yes | QMessageBox.No,QMessageBox.Yes)

例如:点击关闭窗口后提示”是否要退出程序”

    # 关闭按钮
    self.exitbutton = QtWidgets.QPushButton(self.widget3)
    self.exitbutton.setFixedSize(90, 40)
    self.exitbutton.setText("关闭")
    self.exitbutton.setObjectName("exitbutton")
    self.exitbutton.setStyleSheet(qssStyle)
    self.exitbutton.clicked.connect(self.exit)

def exit(self):
    # 点击关闭按钮后提示是否要关闭窗口
    self.closeWindow = QtWidgets.QMessageBox(mainwindow)
    self.okbtn =QtWidgets.QPushButton(QObject.tr(self,"确定"))
    self.okbtn.setObjectName("okbtn")
    self.okbtn.setStyleSheet(qssStyle)
    self.canclebtn = QtWidgets.QPushButton(QObject.tr(self, "取消"))
    self.canclebtn.setObjectName("canclebtn")
    self.canclebtn.setStyleSheet(qssStyle)
    self.closeWindow.addButton(self.okbtn,QMessageBox.AcceptRole)
    self.closeWindow.addButton(self.canclebtn, QMessageBox.RejectRole)
    self.closeWindow.setWindowTitle("提示")
    self.closeWindow.setText("    确定退出程序?")
    self.closeWindow.setWindowIcon(QIcon("KeChengSheJi/pyqt5/text/pic/提示.png"))
    self.closeWindow.setIconPixmap(QPixmap("KeChengSheJi/pyqt5/text/pic/提示 (1).png").scaled(30, 30))
    self.closeWindow.setObjectName("closeWindow")
    self.closeWindow.setStyleSheet(qssStyle)
    self.closeWindow.show()
    # 点击确定按钮后关闭整个程序
    self.okbtn.clicked.connect(mainwindow.close)
QMessageBox弹出式对话框,

3.1、文件选择对话框

例如:选择图片

fname = QFileDialog.getOpenFileName(self, "选择文件", "/", "Image Files(*.jpg;*.png)")

3.2、消息对话框

    btn = QPushButton()
    btn.setText('弹出消息对话框')
    btn.clicked.connect(show)
    def show():
         reply = QMessageBox.information(self,"消息对话框","消息对话框正文",QMessageBox.Yes | QMessageBox.No,QMessageBox.Yes)

3.3、消息提问框

    btn = QPushButton()
    btn.setText('弹出消息对话框')
    btn.clicked.connect(show)
    def show():
         reply = QMessageBox.question(self,"消息提问框","消息提问框正文",QMessageBox.Yes | QMessageBox.No,QMessageBox.Yes)

3.4、警告对话框

    btn = QPushButton()
    btn.setText('弹出警告对话框')
    btn.clicked.connect(show)
    def show():
         reply = QMessageBox.warning(self,"警告对话框","警告对话框正文",QMessageBox.Yes | QMessageBox.No,QMessageBox.Yes)

3.5、严重错误对话框

    btn = QPushButton()
    btn.setText('弹出严重错误对话框')
    btn.clicked.connect(show)
    def show():
         reply = QMessageBox.critical(self,"严重错误对话框","严重错误对话框正文",QMessageBox.Yes | QMessageBox.No,QMessageBox.Yes)

3.6、关于对话框

    btn = QPushButton()
    btn.setText('弹出关于对话框')
    btn.clicked.connect(show)
    def show():
         reply = QMessageBox.about(self,"关于对话框","关于对话框正文",QMessageBox.Yes | QMessageBox.No,QMessageBox.Yes)