我的第一个程序:
这是一个显示一个小窗口的简单例子。我们可以做许多这样的窗口。我们可以调整它的窗口尺寸,最大化或最小化这个窗口。这些需求需要码很多代码。但一些人已经写好了这些功能实现。因为这些需求在很多应用中重复出现了,在这里我们不需要重新写这些代码。PyQt5是一个高级工具套件,为我们封装了很多复杂功能的实现代码,我们可以更加简单的通过函数去实现这些功能。如果我们是在一个低级工具套件中写代码的话,下面例子的代码很有可能需要数百行来实现。
1 #!/usr/bin/python3 2 # -*- coding:utf-8 -*- 3 #__author:Administrator 4 #date:2018/7/18 5 6 import sys 7 #QtWidgets 模块包含的类提供了一套UI元素来创建经典桌面风格用户界面。 8 from PyQt5.QtWidgets import QApplication,QWidget 9 10 if __name__=='__main__': 11 app=QApplication(sys.argv) 12 13 w=QWidget() 14 w.resize(250,150) 15 w.move(300,300) 16 w.setWindowTitle('My First App') 17 w.show() 18 19 sys.exit(app.exec_())
上面的代码示例会在屏幕上显示一个小窗口。
import sys from PyQt5.QtWidgets import QApplication, QWidget
这里我们进行了一些必要模块的导入。最基础的widget组件位于PyQt5.QtWidget模块中
app = QApplication(sys.argv)
所有的PyQt5应用必须创建一个应用(Application)对象。sys.argv参数是一个来自命令行的参数列表。Python脚本可以在shell中运行。这是我们用来控制我们应用启动的一种方法。
w = QWidget()
Qwidget组件是PyQt5中所有用户界面类的基础类。我们给QWidget提供了默认的构造方法。默认构造方法没有父类。没有父类的widget组件将被作为窗口使用。
w.resize(250, 150)
resize()方法调整了widget组件的大小。它现在是250px宽,150px高。
w.move(300, 300)
move()方法移动widget组件到一个位置,这个位置是屏幕上x=300,y=300的坐标。
w.setWindowTitle('Simple')
这里我们设置了我们窗口的标题。这个标题显示在标题栏中。
w.show()
show()方法在屏幕上显示出widget。一个widget对象在这里第一次被在内存中创建,并且之后在屏幕上显示。
sys.exit(app.exec_())
最后,应用进入主循环。在这个地方,事件处理开始执行。主循环用于接收来自窗口触发的事件,并且转发他们到widget应用上处理。如果我们调用exit()方法或主widget组件被销毁,主循环将退出。sys.exit()方法确保一个不留垃圾的退出。系统环境将会被通知应用是怎样被结束的。
exec_()方法有一个下划线。因为exec是Python保留关键字。因此,用exec_()来代替。
一个简单的应用图标
应用图标是一个常常显示在标题栏左上方角落的小图片。在下面的例子里,我们将展示我们如何在PyQt5中显示应用图标。我们也将介绍一些新方法的使用。
1 #!/usr/bin/python3 2 # -*- coding:utf-8 -*- 3 #__author:Administrator 4 #date:2018/7/23 5 6 import sys 7 from PyQt5.QtWidgets import QApplication,QWidget 8 from PyQt5.QtGui import QIcon 9 10 class Example(QWidget): 11 def __init__(self): 12 super().__init__() 13 self.initUI() 14 def initUI(self): 15 ''' 16 #GUI的创建授予initUI()方法完成。 17 setGeometry() 18 做了两件事:将窗口在屏幕上显示,并设置了它的尺寸。setGeometry() 19 方法的前两个参数定位了窗口的x轴和y轴位置。第三个参数是定义窗口的宽度,第四个参数是定义窗口的高度。事实上,这是将resize() 20 和move() 21 方法融合在一个方法内 22 :return: 23 ''' 24 self.setGeometry(300,300,250,150) 25 self.setWindowTitle("第一个程序") 26 self.setWindowIcon(QIcon("ico.png")) 27 self.show() 28 29 if __name__=="__main__": 30 app=QApplication(sys.argv) 31 ex=Example() 32 sys.exit(app.exec_())
显示一个提示文本
我们可以给我们的任何widget组件提供气泡帮助提示框
1 import sys 2 from PyQt5.QtWidgets import QApplication,QWidget,QPushButton,QToolTip 3 from PyQt5.QtGui import QIcon,QFont 4 5 class Example(QWidget): 6 def __init__(self): 7 super().__init__() 8 self.initUI() 9 def initUI(self): 10 QToolTip.setFont(QFont('SansSerif',10)) 11 self.setToolTip('This is a <b>QWidget</b> widget') 12 13 btn=QPushButton('Button',self) 14 btn.setToolTip('This is a <b>QPushButton</b> widget') 15 #这里改变了按钮的大小,并移动了在窗口上的位置。setHint()方法给了按钮一个推荐的大小。 16 btn.resize(btn.sizeHint()) 17 btn.move(50,50) 18 19 20 21 self.setGeometry(300,300,300,200) 22 self.setWindowTitle("显示提示字体") 23 self.setWindowIcon(QIcon("ico.png")) 24 self.show() 25 26 if __name__=="__main__": 27 app=QApplication(sys.argv) 28 ex=Example() 29 sys.exit(app.exec_())
这个例子中,我们为两个PyQt5组件显示了提示框。
1
|
QToolTip.setFont(QFont( 'SansSerif' , 10 )) |
这个静态方法设置了用于提示框的字体。我们使用10px大小的SansSerif字体。
1
|
self .setToolTip( 'This is a <b>QWidget</b> widget' ) |
为了创建提示框,我们调用了setTooltip()方法。我们可以在提示框中使用富文本格式。
1
2
|
btn = QPushButton( 'Button' , self ) btn.setToolTip( 'This is a <b>QPushButton</b> widget' ) |
我们创建了一个按钮组件并且为它设置一个提示框。
1
2
|
btn.resize(btn.sizeHint()) btn.move( 50 , 50 ) |
这里改变了按钮的大小,并移动了在窗口上的位置。setHint()方法给了按钮一个推荐的大小。
关闭窗口
明显的关闭窗口的方法是点击标题栏的X标记。在下面的例子中,我们将展示怎么通过程序来关闭我们的窗口。我们将简单的触及信号和槽机制。
1
|
QPushButton(string text, QWidget parent = None ) |
text参数是将显示在按钮中的内容。parent参数是一个用来放置我们按钮的组件。在我们的例子中将会是QWidget组件。一个应用的组件是分层结构的。在这个分层内,大多数组件都有父类。没有父类的组件是顶级窗口。
1 import sys 2 from PyQt5.QtWidgets import QApplication,QWidget,QPushButton,QToolTip 3 from PyQt5.QtGui import QIcon,QFont 4 from PyQt5.QtCore import QCoreApplication 5 6 class Example(QWidget): 7 def __init__(self): 8 super().__init__() 9 self.initUI() 10 def initUI(self): 11 QToolTip.setFont(QFont(u'微软雅黑',10)) 12 self.setToolTip('微软雅黑This is a <b>QWidget</b> widget') 13 14 self.btn=QPushButton('Button',self) 15 self.btn.setToolTip('正宗的微软雅黑This is a <b>QPushButton</b> widget') 16 #这里改变了按钮的大小,并移动了在窗口上的位置。setHint()方法给了按钮一个推荐的大小。 17 self.btn.resize(self.btn.sizeHint()) 18 self.btn.move(50,50) 19 20 self.qbtn=QPushButton('Quit',self) 21 self.qbtn.setToolTip('点击按钮,退出程序') 22 self.qbtn.clicked.connect(QCoreApplication.instance().quit) 23 self.qbtn.resize(self.qbtn.sizeHint()) 24 self.qbtn.move(150,50) 25 26 27 28 self.setGeometry(300,300,300,200) 29 self.setWindowTitle("点击退出程序") 30 self.setWindowIcon(QIcon("ico.png")) 31 self.show() 32 33 if __name__=="__main__": 34 app=QApplication(sys.argv) 35 ex=Example() 36 sys.exit(app.exec_())
在这个例子中,我们创建一个退出按钮,一旦按下按钮,应用将会结束。
1
|
from PyQt5.QtCore import QCoreApplication |
我们需要一个来自QtCore的对象模块。
1
|
qbtn = QPushButton( 'Quit' , self ) |
我们创建了一个按钮。按钮是一个QPushButton类的实例。构造方法的第一个参数是显示在button上的标签文本。第二个参数是父组件。父组件是Example组件,它继承了QWiget类。
1
|
qbtn.clicked.connect(QCoreApplication.instance().quit) |
在PyQt5中,事件处理系统由信号&槽机制建立。如果我们点击了按钮,信号clicked被发送。槽可以是Qt内置的槽或Python 的一个方法调用。QCoreApplication类包含了主事件循环;它处理和转发所有事件。instance()方法给我们返回一个实例化对象。注意QCoreAppli类由QApplication创建。点击信号连接到quit()方法,将结束应用。事件通信在两个对象之间进行:发送者和接受者。发送者是按钮,接受者是应用对象。
Message Box
默认的,如果我们点击了标题栏上的x按钮,QWidget会被关闭。又是我们希望修改这个默认动作。举个例子,如果我们有个文件在编辑器内打开,并且我们对这个文件做了一些修改。 我们显示一个message box来确认这个动作。
1 #!/usr/bin/python3 2 # -*- coding:utf-8 -*- 3 #__author:Administrator 4 #date:2018/7/23 5 6 import sys 7 from PyQt5.QtWidgets import QApplication,QWidget,QPushButton,QToolTip,QMessageBox 8 from PyQt5.QtGui import QIcon,QFont 9 from PyQt5.QtCore import QCoreApplication 10 11 class Example(QWidget): 12 def __init__(self): 13 super().__init__() 14 self.initUI() 15 def initUI(self): 16 QToolTip.setFont(QFont(u'微软雅黑',10)) 17 self.setToolTip('微软雅黑This is a <b>QWidget</b> widget') 18 19 self.btn=QPushButton('Button',self) 20 self.btn.setToolTip('正宗的微软雅黑This is a <b>QPushButton</b> widget') 21 #这里改变了按钮的大小,并移动了在窗口上的位置。setHint()方法给了按钮一个推荐的大小。 22 self.btn.resize(self.btn.sizeHint()) 23 self.btn.move(50,50) 24 25 self.qbtn=QPushButton('Quit',self) 26 self.qbtn.setToolTip('点击按钮,退出程序') 27 # self.qbtn.clicked.connect(QCoreApplication.instance().quit) 28 self.qbtn.clicked.connect(QCoreApplication.instance().quit) 29 self.qbtn.resize(self.qbtn.sizeHint()) 30 self.qbtn.move(150,50) 31 32 self.setGeometry(300,300,300,200) 33 self.setWindowTitle("点击退出程序") 34 self.setWindowIcon(QIcon("ico.png")) 35 self.show() 36 37 def closeEvent(self, event): 38 reply=QMessageBox.question(self,'Message',"确定退出?",QMessageBox.Yes|QMessageBox.No,QMessageBox.No) 39 if reply==QMessageBox.Yes: 40 event.accept() 41 else: 42 event.ignore() 43 44 if __name__=="__main__": 45 app=QApplication(sys.argv) 46 ex=Example() 47 sys.exit(app.exec_())
如果我们关闭一个QWidget,QCloseEvent类事件将被生成。要修改组件动作我们需要重新实现closeEvent()事件处理方法。
1
2
3
|
reply = QMessageBox.question( self , 'Message' , "Are you sure to quit?" , QMessageBox.Yes | QMessageBox.No, QMessageBox.No) |
我们现实一个带两个按钮的message box:YES和No按钮。代码中第一个字符串的内容被显示在标题栏上。第二个字符串是对话框上显示的文本。第三个参数指定了显示在对话框上的按钮集合。最后一个参数是默认选中的按钮。这个按钮一开始就获得焦点。返回值被储存在reply变量中。
1
2
3
4
|
if reply = = QtGui.QMessageBox.Yes: event.accept() else : event.ignore() |
在这里我们测试一下返回值。代码逻辑是如果我们点击Yes按钮,我们接收到的事件关闭事件,这将导致了组件的关闭和应用的结束。否则不是点击Yes按钮的话我们将忽略将关闭事件。
屏幕上的居中窗口
下面的脚本展示我们如何把窗口居中显示到桌面窗口。
1 #!/usr/bin/python3 2 # -*- coding:utf-8 -*- 3 #__author:Administrator 4 #date:2018/7/23 5 6 import sys 7 from PyQt5.QtWidgets import QApplication,QDesktopWidget,QWidget,QPushButton,QToolTip,QMessageBox 8 from PyQt5.QtGui import QIcon,QFont 9 from PyQt5.QtCore import QCoreApplication 10 11 class Example(QWidget): 12 def __init__(self): 13 super().__init__() 14 self.initUI() 15 def initUI(self): 16 QToolTip.setFont(QFont(u'微软雅黑',10)) 17 self.setToolTip('微软雅黑This is a <b>QWidget</b> widget') 18 19 self.btn=QPushButton('Button',self) 20 self.btn.setToolTip('正宗的微软雅黑This is a <b>QPushButton</b> widget') 21 #这里改变了按钮的大小,并移动了在窗口上的位置。setHint()方法给了按钮一个推荐的大小。 22 self.btn.resize(self.btn.sizeHint()) 23 self.btn.move(50,50) 24 25 self.qbtn=QPushButton('Quit',self) 26 self.qbtn.setToolTip('点击按钮,退出程序') 27 # self.qbtn.clicked.connect(QCoreApplication.instance().quit) 28 self.qbtn.clicked.connect(QCoreApplication.instance().quit) 29 self.qbtn.resize(self.qbtn.sizeHint()) 30 self.qbtn.move(150,50) 31 32 # self.setGeometry(300,300,300,200) 33 self.resize(300,200) 34 self.center() 35 self.setWindowTitle("窗口居中显示") 36 self.setWindowIcon(QIcon("ico.png")) 37 self.show() 38 39 def center(self): 40 qr=self.frameGeometry() 41 cp=QDesktopWidget().availableGeometry().center() 42 qr.moveCenter(cp) 43 self.move(qr.topLeft()) 44 45 def closeEvent(self, event): 46 reply=QMessageBox.question(self,'Message',"确定退出?",QMessageBox.Yes|QMessageBox.No,QMessageBox.No) 47 if reply==QMessageBox.Yes: 48 event.accept() 49 else: 50 event.ignore() 51 52 if __name__=="__main__": 53 app=QApplication(sys.argv) 54 ex=Example() 55 sys.exit(app.exec_())
QtGui.QDesktopWidget类提供了我们桌面窗口的信息,包含了屏幕尺寸。
1
|
self .center() |
将窗口居中放置的代码在自定义的center()方法中。
1
|
qr = self .frameGeometry() |
我们获得主窗口的一个矩形特定几何图形。这包含了窗口的框架。
1
|
cp = QDesktopWidget().availableGeometry().center() |
我们算出相对于显示器的绝对值。并且从这个绝对值中,我们获得了屏幕中心点。
1
|
qr.moveCenter(cp) |
我们的矩形已经设置好了它的宽和高。现在我们把矩形的中心设置到屏幕的中间去。矩形的大小并不会改变。
1
|
self .move(qr.topLeft()) |