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的教程中，我们讨论了一些基本的内容。

翻译和补充的有误的地方，欢迎在评论区指正。