import sys
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.show()
sys.exit(app.exec_())
上面的代码实例会在屏幕上显示一个小的窗口。
在这里,我们进行了一些必要的模块导入,最基础的widget组件位于PyQt5.QtWidget模块中
import sys
from PyQt5.QtWidgets import QApplication, QWidget
所有的PyQt5应用必须创建一个应用(Application)对象。sys.argv参数是一个来自命令行的参数列表。Python脚本可以在shell中运行。这是我们用来控制我们应用启动的一种方法。
app = QApplication(sys.argv)
Qwidget组件是PyQt5中所有用户界面类的基础类。我们给QWidget提供了默认的构造方法。默认构造方法没有父类。没有父类的widget组件将被作为窗口使用。
w = QWidget()
resize()方法调整了widget组件的大小。它现在是250px宽,150px高。
w.resize(250, 150)
move()方法移动widget组件到一个位置,这个位置是屏幕上x=300,y=300的坐标。
w.move(300, 300)
这里我们设置了我们窗口的标题。这个标题显示在标题栏中。
w.setWindowTitle('Simple')
一个简单的应用图标
应用图标是一个常常显示在标题栏左上方角落的小图片。在下面的例子里,我们将展示我们如何在PyQt5中显示应用图标。我们也将介绍一些新方法的使用。
#!/usr/bin/python3
# -*- coding: utf-8 -*-
import sys
from PyQt5.QtWidgets import QApplication, QWidget
from PyQt5.QtGui import QIcon
class Example(QWidget):
def __init__(self):
super().__init__()
self.initUI()
def initUI(self):
self.setGeometry(300, 300, 300, 220)
self.setWindowTitle('Icon')
self.setWindowIcon(QIcon('web.png'))
self.show()
if __name__ == '__main__':
app = QApplication(sys.argv)
ex = Example()
sys.exit(app.exec_())
这里我们创建了一个新类叫做Example。Example类继承自QWidget类。这意味着我们调用了两个构造方法:第一个是Example类的构造方法,第二个是被继承类的构造方法。super()方法返回了Example类的父类对象,并且我们调用了父类的构造方法。init()方法是Python语言中的构造方法。
GUI的创建授予initUI()方法完成。
self.setGeometry(300, 300, 300, 220)
self.setWindowTitle('Icon')
self.setWindowIcon(QIcon('web.png'))
三个方法都继承自QWidgets类。setGeometry()做了两件事:将窗口在屏幕上显示,并设置了它的尺寸。setGeometry()方法的前两个参数定位了窗口的x轴和y轴位置。第三个参数是定义窗口的宽度,第四个参数是定义窗口的高度。事实上,这是将resize()和move()方法融合在一个方法内。为了做好这个例子,我们创建了一个QIcon对象。QIcon对象接收一个我们要显示的图片路径作为参数。
if __name__ == '__main__':
app = QApplication(sys.argv)
ex = Example()
sys.exit(app.exec_())
应用和example对象被创建。主循环被启动。
显示一个提示文本
我们可以给我们的任何widget组件提供气泡帮助提示框。
#!/usr/bin/python3
# -*- coding: utf-8 -*-
"""
This example shows a tooltip on
a window and a button.
"""
import sys
from PyQt5.QtWidgets import (QWidget, QToolTip,
QPushButton, QApplication)
from PyQt5.QtGui import QFont
class Example(QWidget):
def __init__(self):
super().__init__()
self.initUI()
def initUI(self):
QToolTip.setFont(QFont('SansSerif', 10))
self.setToolTip('This is a QWidget widget')
btn = QPushButton('Button', self)
btn.setToolTip('This is a QPushButton widget')
btn.resize(btn.sizeHint())
btn.move(50, 50)
self.setGeometry(300, 300, 300, 200)
self.setWindowTitle('Tooltips')
self.show()
if __name__ == '__main__':
app = QApplication(sys.argv)
ex = Example()
sys.exit(app.exec_())
在这个例子中,我们为两个PyQt5组件显示了提示框。
QToolTip.setFont(QFont('SansSerif', 10))
这个静态方法设置了用于提示框的字体。我们使用10px大小的SansSerif字体。
为了创建提示框,我们调用了setTooltip()方法。我们可以在提示框中使用富文本格式。self.setToolTip('This is a QWidget widget')
为了创建提示框,我们调用了setTooltip()方法。我们可以在提示框中使用富文本格式。
btn = QPushButton('Button', self)
btn.setToolTip('This is a QPushButton widget')
这里改变了按钮的大小,并移动了在窗口上的位置。setHint()方法给了按钮一个推荐的大小。
btn.resize(btn.sizeHint())
btn.move(50, 50)
关闭窗口
明显的关闭窗口的方法是点击标题栏的X标记。在下面的例子中,我们将展示怎么通过程序来关闭我们的窗口。我们将简单的触及信号和槽机制。
QPushButton(string text, QWidget parent = None)
text参数是将显示在按钮中的内容。parent参数是一个用来放置我们按钮的组件。在我们的例子中将会是QWidget组件。一个应用的组件是分层结构的。在这个分层内,大多数组件都有父类。没有父类的组件是顶级窗口。
import sys
from PyQt5.QtWidgets import QWidget, QPushButton, QApplication from PyQt5.QtCore import QCoreApplication
class Example(QWidget):
def __init__(self):
super().__init_()
self.initUI()
def initUI(self):
qbtn = QPushButton('Quit', self)
qbtn.clicked.connect(QCoreApplication.instance().quit)
qbtn.resize(qbtn.sizeHint())
qbtn.move(50, 50)
self.setGeometry(300, 300, 250, 150)
self.setWindowTitle('Quit button')
self.show()
if __name__ == '__main__':
app = QApplication(sys.argv)
ex = Example()
sys.exit(app.exec_())
- 我们创建了一个按钮。按钮是一个QPushButton类的实例。构造方法的第一个参数是显示在button上的标签文本。第二个参数是父组件。父组件是Example组件,它继承了QWiget类。
qbtn = QPushButton('Quit', self)
- 在PyQt5中,事件处理系统由信号&槽机制建立。如果我们点击了按钮,信号clicked被发送。槽可以是Qt内置的槽或Python 的一个方法调用。QCoreApplication类包含了主事件循环;它处理和转发所有事件。instance()方法给我们返回一个实例化对象。注意QCoreAppli类由QApplication创建。点击信号连接到quit()方法,将结束应用。事件通信在两个对象之间进行:发送者和接受者。发送者是按钮,接受者是应用对象。
Message Box
默认的,如果我们点击了标题栏上的x按钮,QWidget会被关闭。又是我们希望修改这个默认动作。举个例子,如果我们有个文件在编辑器内打开,并且我们对这个文件做了一些修改。 我们显示一个message box来确认这个动作。
#!/usr/bin/python3
# -*- coding: utf-8 -*-
"""
This program shows a confirmation
message box when we click on the close
button of the application window.
"""
import sys
from PyQt5.QtWidgets import QWidget, QMessageBox, QApplication
class Example(QWidget):
def __init__(self):
super().__init__()
self.initUI()
def initUI(self):
self.setGeometry(300, 300, 250, 150)
self.setWindowTitle('Message box')
self.show()
def closeEvent(self, event):
reply = QMessageBox.question(self, 'Message',
"Are you sure to quit?", QMessageBox.Yes |
QMessageBox.No, QMessageBox.No)
if reply == QMessageBox.Yes:
event.accept()
else:
event.ignore()
if __name__ == '__main__':
app = QApplication(sys.argv)
ex = Example()
sys.exit(app.exec_())
如果我们关闭一个QWidget,QCloseEvent类事件将被生成。要修改组件动作我们需要重新实现closeEvent()事件处理方法。
reply = QMessageBox.question(self, 'Message',
"Are you sure to quit?", QMessageBox.Yes |
QMessageBox.No, QMessageBox.No)
我们现实一个带两个按钮的message box:YES和No按钮。代码中第一个字符串的内容被显示在标题栏上。第二个字符串是对话框上显示的文本。第三个参数指定了显示在对话框上的按钮集合。最后一个参数是默认选中的按钮。这个按钮一开始就获得焦点。返回值被储存在reply变量中。
在这里我们测试一下返回值。代码逻辑是如果我们点击Yes按钮,我们接收到的事件关闭事件,这将导致了组件的关闭和应用的结束。否则不是点击Yes按钮的话我们将忽略将关闭事件。
屏幕上居中的窗口
下面的脚本展示我们如何把窗口居中显示到桌面窗口。
#!/usr/bin/python3
# -*- coding: utf-8 -*-
"""
This program centers a window
on the screen.
"""
import sys
from PyQt5.QtWidgets import QWidget, QDesktopWidget, QApplication
class Example(QWidget):
def __init__(self):
super().__init__()
self.initUI()
def initUI(self):
self.resize(250, 150)
self.center()
self.setWindowTitle('Center')
self.show()
def center(self):
qr = self.frameGeometry()
cp = QDesktopWidget().availableGeometry().center()
qr.moveCenter(cp)
self.move(qr.topLeft())
if __name__ == '__main__':
app = QApplication(sys.argv)
ex = Example()
sys.exit(app.exec_())
QtGui.QDesktopWidget
类提供了我们桌面窗口的信息,包含了屏幕尺寸。
-
self.center()
将窗口居中放置的代码在自定义的center()方法中 - 我们获得主窗口的一个矩形特定几何图形。这包含了窗口的框架。
qr = self.frameGeometry()
- 我们算出相对于显示器的绝对值。并且从这个绝对值中,我们获得了屏幕中心点。
cp = QDesktopWidget().availableGeometry().center()
- 我们的矩形已经设置好了它的宽和高。现在我们把矩形的中心设置到屏幕的中间去。矩形的大小并不会改变。
qr.moveCenter(cp)
- 我们移动了应用窗口的左上方的点到qr矩形的左上方的点,因此居中显示在我们的屏幕上。
self.move(qr.topLeft())