PyQt4入门学习笔记（一）
PyQt4入门学习笔记（一）
一直没有找到什么好的pyqt4的教程，偶然在google上搜到一篇不错的入门文档，翻译过来，留以后再复习。
原始链接如下：
http://zetcode.com/gui/pyqt4/firstprograms/
在这篇PyQt4的入门文档，我们讲学习一些基础功能。
简单的例子
这是一个显示一个小窗口的简单例子。我们可以对这个窗口做一些操作。我们可以改变它的大小，最大化它，或者最小化它。这需要大量的编码。有人已经写好了这些基础函数，因为它在绝大部分应用中重复出现，不需要重复的去编码。PyQt4是一个高级的工具包。如果我们在一个低级的工具包里编码，下面这个例子可能轻松过百行。
#!/usr/bin/python
# -*- coding: utf-8 -*-
"""
ZetCode PyQt4 tutorial
In this example, we create a simple
window in PyQt4.
author: Jan Bodnar
website: zetcode.com
last edited: October 2011
"""
import sys
from PyQt4 import QtGui
def main():
app = QtGui.QApplication(sys.argv)
w = QtGui.QWidget()
w.resize(250, 150)
w.move(300, 300)
w.setWindowTitle('Simple')
w.show()
sys.exit(app.exec_())
if __name__ == '__main__':
main()
上面这段代码运行后将在屏幕上显示一个小窗口。
import sys
from PyQt4 import QtGui
我们在这里提供必要的import，基础的GUI窗口部件在QtGui模块里。
app = QtGui.QApplication(sys.argv)
每一个PyQt4的应用必须创建一个Application对象。参数sys.argv是一个来自命令行的参数列表。python脚本可以从shell脚本里运行。这是一种我们可以控制我们脚本启动的方式。
w = QtGui.QWidget()
QtGui.Qwidgt部件是一个是pyqt4里所有用户接口对象中的基类。我们用默认的QtGui.Qwidgt构造器(constructor)。默认的构造器没有父类，一个不带父类的窗口部件在窗口被调用。
w.resize(250, 150)
这个resize()方法改变窗口大小。上述语句把窗口改成了250px宽，150px高。
w.move(300, 300)
这个move()方法移动窗口到屏幕上坐标为x,y=(300,300)的位置
w.setWindowTitle('Simple')
上述语句使我们为我们的窗口设置标题，标题会被显示在标题栏(titlebar)
w.show()
这个show()方法把窗口部件显示在屏幕上。一个窗口是先在内存中创建，然后再在屏幕上显示。
sys.exit(app.exec_())
最终，我们结束了应用的主循环。主循环是从窗口系统中接收事件并快速的发往应用窗口。当我们调用exit()方法或者关闭主窗口时，主循环结束。这个sys.exit()方法是确保一个干净的关闭。
这个exec_()方法有个下划线，因为exec是python的一个关键字，所以用exec_替代了。
如果你按照上面的代码运行，那么应该会得到类似下面这样的状态（我自己修改了窗口的大小，因为surfacebook的高分辨率几乎让我看不到原来的标题，但样式大致不会变）
应用图标
应用图标(application icon)是一个被用来显示在标题栏顶部左侧角落的小图片。在下面这个例子中，我们将展示如何在pyqt4里面实现它。我们同时也会介绍一些新方法。
#!/usr/bin/python
# -- coding: utf-8 --
"""
ZetCode PyQt4 tutorial
This example shows an icon
in the titlebar of the window.
author: Jan Bodnar
website: zetcode.com
last edited: October 2011
"""
import sys
from PyQt4 import QtGui
class Example(QtGui.QWidget):
def __init__(self):
super(Example, self).__init__()
self.initUI()
def initUI(self):
self.setGeometry(300, 300, 250, 150)
self.setWindowTitle('Icon')
self.setWindowIcon(QtGui.QIcon('web.png'))
self.show()
def main():
app = QtGui.QApplication(sys.argv)
ex = Example()
sys.exit(app.exec_())
if __name__ == '__main__':
main()
我们前一个例子是用面向过程的风格编程。python是一门既支持面向过程又支持面向对象的语言。在pyqt4内编程，意味着OOP（面向对象）。
class Example(QtGui.QWidget):
def __init__(self):
super(Example, self).__init__()
...
面向对象中三个最重要的事是类(class)，数据(data)，和方法(method)。在这里我们创建了一个叫做Example的新类。这个Example类是继承于QtGui.QWidget，这意味着我们可以调用两个构造器，第一个是对Example类，另一个是对被继承的类。
super()方法返回Example类的父类对象。__init__()方法是python的一个构造器方法。
self.initUI()
GUI的创建是被委托给initUI()方法。
self.setGeometry(300, 300, 250, 150)
self.setWindowTitle('Icon')
self.setWindowIcon(QtGui.QIcon('web.png'))
这三个方法都是从QtGui.QWidget类继承过来。
setGeometry()方法做两个事。它定位了窗口在屏幕的位置并且设定窗口大小。前两个参数是窗口的x,y坐标。第三个参数是窗口宽度，第四个是窗口高度。事实上，它结合了resize()和move()方法。最后一个方法设定了应用的图标。为了做到这个，我们创建了一个QtGui.QIcon类型的对象。QtGui.QIcon接受一个图片的路径（就是你想用来做图标的图片）
def main():
app = QtGui.QApplication(sys.argv)
ex = Example()
sys.exit(app.exec_())
if __name__ == '__main__':
main()
启动代码被放在一个main()方法内（我想这叫函数更好？）。这是一个python 的习惯用法。
运行后类似下图
展示一个提示工具
我们可以给我们的任何一个部件提供一个气泡提示。
#!/usr/bin/python
# -*- coding: utf-8 -*-
"""
ZetCode PyQt4 tutorial
This example shows a tooltip on
a window and a button
author: Jan Bodnar
website: zetcode.com
last edited: October 2011
"""
import sys
from PyQt4 import QtGui
class Example(QtGui.QWidget):
def __init__(self):
super(Example, self).__init__()
self.initUI()
def initUI(self):
QtGui.QToolTip.setFont(QtGui.QFont('SansSerif', 10))
self.setToolTip('This is a <b>QWidget</b> widget')
btn = QtGui.QPushButton('Button', self)
btn.setToolTip('This is a <b>QPushButton</b> widget')
btn.resize(btn.sizeHint())
btn.move(50, 50)
self.setGeometry(300, 300, 250, 150)
self.setWindowTitle('Tooltips')
self.show()
def main():
app = QtGui.QApplication(sys.argv)
ex = Example()
sys.exit(app.exec_())
if __name__ == '__main__':
main()
在这个例子里，我们为两个pyqt4部件显示了一个提示工具。
QtGui.QToolTip.setFont(QtGui.QFont('SansSerif', 10))
这个基础的方法设定一个被用来渲染提示工具的字体。我们用了一个10px的SansSerif字体。
self.setToolTip('This is a <b>QWidget</b> widget')
为了创建一个提示工具，我们调用setTooltip()方法。我们同时可以使用富文本。
btn = QtGui.QPushButton('Button', self)
btn.setToolTip('This is a <b>QPushButton</b> widget')
我们创建了一个按钮(button)，并且为其设定一个提示工具。
btn.resize(btn.sizeHint())
btn.move(50, 50)
这个按钮在窗口上被改变大小并且被移动。这个sizeHint()方法提供了一个按钮的推荐尺寸。
运行上面的程序后，效果类似下图
关闭窗口##
我们之前关闭窗口的方法是点击标题栏的"x"。在下一个例子里，我们将会展示我们可以程序化的关闭我们的窗口。我们将会稍稍的接触一下信号(signal)和槽(slot)。
下面是一个我们将会用在我们例子中的QtGui.QPushButton的构造器。
QPushButton(string text, QWidget parent = None)
text参数是一个被用来展示在按钮上的字符串。parent是一个我们按钮的父类部件，在我们的例子里，它将会是QtGui.QWidget
#!/usr/bin/python
# -*- coding: utf-8 -*-
"""
ZetCode PyQt4 tutorial
This program creates a quit
button. When we press the button,
the application terminates.
author: Jan Bodnar
website: zetcode.com
last edited: October 2011
"""
import sys
from PyQt4 import QtGui, QtCore
class Example(QtGui.QWidget):
def __init__(self):
super(Example, self).__init__()
self.initUI()
def initUI(self):
qbtn = QtGui.QPushButton('Quit', self)
qbtn.clicked.connect(QtCore.QCoreApplication.instance().quit)
qbtn.resize(qbtn.sizeHint())
qbtn.move(50, 50)
self.setGeometry(300, 300, 250, 150)
self.setWindowTitle('Quit button')
self.show()
def main():
app = QtGui.QApplication(sys.argv)
ex = Example()
sys.exit(app.exec_())
if __name__ == '__main__':
main()
在这个例子里，我们创建了一个离开按钮。点击按钮，应用将会被终止
运行后效果类似下图
消息盒子##
默认的，如果我们点击了标题栏的"X"，QtGui.QWidget将会被关闭。有些时候我们想要修改这个默认的行为。举个例子，如果我们有一个文件在一个编辑器内被打开，并且做了些修改，退出时我们会显示一个消息盒子让人确定这个动作。
#!/usr/bin/python
# -*- coding: utf-8 -*-
"""
ZetCode PyQt4 tutorial
This program shows a confirmation
message box when we click on the close
button of the application window.
author: Jan Bodnar
website: zetcode.com
last edited: October 2011
"""
import sys
from PyQt4 import QtGui
class Example(QtGui.QWidget):
def __init__(self):
super(Example, self).__init__()
self.initUI()
def initUI(self):
self.setGeometry(300, 300, 250, 150)
self.setWindowTitle('Message box')
self.show()
def closeEvent(self, event):
reply = QtGui.QMessageBox.question(self, 'Message',
"Are you sure to quit?", QtGui.QMessageBox.Yes |
QtGui.QMessageBox.No, QtGui.QMessageBox.No)
if reply == QtGui.QMessageBox.Yes:
event.accept()
else:
event.ignore()
def main():
app = QtGui.QApplication(sys.argv)
ex = Example()
sys.exit(app.exec_())
if __name__ == '__main__':
main()
如果我们关闭QtGui.QWidget，QtGui.QCloseEvent将会被触发。为了修改部件行为我们需要重新实现closeEvent事件handler。
reply = QtGui.QMessageBox.question(self, 'Message',
"Are you sure to quit?", QtGui.QMessageBox.Yes |
QtGui.QMessageBox.No, QtGui.QMessageBox.No)
我们展示了一个带有两个按钮的消息盒子：yes和no，第二个字符串是对话框显示的字符串。第三个参数具体规定了按钮和显示文字的组合。最后一个参数是默认的按钮。它是一个初始化的键盘focus的按钮。（就是直接enter时选择的按钮）。返回值被存储在reply变量中。
if reply == QtGui.QMessageBox.Yes:
event.accept()
else:
event.ignore()
我们测试了返回值。如果点击了yes按钮，我们接受一个关闭部件的时间并且关闭应用。其他情况我们关闭这个事件。
运行后类似下图：
将窗口置于屏幕中间##
下面的脚本显示我们如何在桌面屏幕上中心化一个窗口
#!/usr/bin/python
# -*- coding: utf-8 -*-
"""
ZetCode PyQt4 tutorial
This program centers a window
on the screen.
author: Jan Bodnar
website: zetcode.com
last edited: October 2011
"""
import sys
from PyQt4 import QtGui
class Example(QtGui.QWidget):
def __init__(self):
super(Example, self).__init__()
self.initUI()
def initUI(self):
self.resize(250, 150)
self.center()
self.setWindowTitle('Center')
self.show()
def center(self):
qr = self.frameGeometry()
cp = QtGui.QDesktopWidget().availableGeometry().center()
qr.moveCenter(cp)
self.move(qr.topLeft())
def main():
app = QtGui.QApplication(sys.argv)
ex = Example()
sys.exit(app.exec_())
if __name__ == '__main__':
main()
QtGui.QDesktopWidget类提供了关于用户桌面的信息，包括屏幕尺寸
self.center()
这行代码将会将窗口置于屏幕中心
qr = self.frameGeometry()
我们在主窗口内得到一个指定的长方形几何体。
cp = QtGui.QDesktopWidget().availableGeometry().center()
我们得到了显示器的中心点。
qr.moveCenter(cp)
我们的长方形窗口已经有了宽度和高度，现在我们设定它的中心在屏幕中心。它的大小不变。
self.move(qr.topLeft())
我们移动应用窗口的左上点到长方形的左上角，至此我们就将窗口移动到了中央。
在这一节pyqt4的教程中，我们讨论了一些基本的内容。
翻译和补充的有误的地方，欢迎在评论区指正。
