使用PyQt来编写第一个Python GUI程序

本文由 伯乐在线 - Lane 翻译,Daetalus 校稿。未经许可,禁止转载!
英文出处:pythonforengineers.com。欢迎加入翻译小组

简介

许多人在学习如何创建一个 GUI 应用的时候都感到十分的困难。其中最重要的原因是,他们不知道应该从何下手。大多数的教程都只有文字,但事实上仅仅依靠文字很难学会 GUI 编程,因为 GUI 应用大多数都是基于视觉上的。

我们将通过创建一个简单的 GUI 应用来避免上面提到的这些问题,并且向你展示着手开始这件事其实是多么的简单。一旦你明白了这些基本的知识,以后的进一步学习将会变得十分的容易。

这就是我们即将完成的东西:

这是一个简单的 GUI 应用,根据输入的价格(price)和税率(tax rate),计算出最终的价格(final price)。

大多数的教程都试图直接通过代码来对 GUI 应用进行布局,但是这样做实在是很费劲。我们将要做的是利用优秀的 QT Designer 工具来对我们的应用进行布局。

所以不要再劳神费力的用代码来设计界面了。现在开始所有的东西都将通过图形界面来搞定。

所有的代码都在这里

前提条件

如果你已经接受了我的建议并且安装了 Anaconda,你应该已经安装好了 PyQt4。如果没有的话,你需要从这里先下载它。

同时你还需要一个 Qt Designer。我建议你下载整个的 QT 套件,因为其中还包含了许多其他有用的工具。

开始着手

提示:当你需要查看更多细节的时候,你可以通过点击下方的任意图片来查看其原图。(译者注:你可能需要查看原始链接来查看原图)

打开 QT Designer。在弹出的窗口中,选择 Main Window,这样它会给你一个空白的画板。

接下来在左侧选择Text Edit

Text Edit 拖动到主窗口:

看见右边我粗略的用红圈框起来的部分了吗?那就是定义这个对象的名字的地方。这个名字将是我们通过 Python 代码调用到这个对象的变量名,所以请尽量取一个有意义的名称。

我将它取名为price_box,因为我们会在这里输入价格。然后我们需要给这个输入框添加一个 label,以便让用户更加清楚这个输入框的作用。

我在上图中圈出了 label。把它拖动到主窗口当中来。

现在它被默认称作TextLabel。双击并将其命名为Price。你还可以将这段文字字体加大并且设置为粗体,就像下边看到的这样:

对于税率(tax)输入框,我们会使用另外的一个东西。找到spin box

左侧用圈框起来的部分就是一个spin box。它会限定你能输入的值。其实并不是非得要用spin box,这样做只不过是为了更好地展示 QT Creator 所能提供的各种不同的组件。将spin box 拖到窗口中。然后我们要做的第一件事情就是将objectName 改为一个有意义的名字,例如我将其设置为tax_rate。请记住这将会是你在 Python 代码中调用它的时候会使用到的变量名。

我们可以为我们的spin box 设置一个默认值。我选择将其设置为 20:

如果你仔细观察上图,你会发现我们也可以设置它的最小值和最大值。不过我并不打算去更改他们。

同样地,我会为它添加一个标签叫做Tax Rate。然后看看我们接下来会用到的圈起来的Push Button

好的,现在选择Push Button 然后将其拖动到我们的窗口中来。

这个按钮现在显示的是PushButton,这并不是一个很有意义的名字。到了这一步,你应该知道该怎么更改它了。不过在此之前,我们要把这个按钮的名字(不是显示用的文字列)改为calc_tax_button

然后,我们可以修改真正的显示文字列了:

然后选择另外一个Text Edit 并将其拖动到窗口中。你不需要给它添加标签,因为我们会把我们的结果输出到这里。把它的名字改为results_window(下图中没有画出来,但你应该已经知道该如何操作了)。

如果你觉得需要的话,你可以添加一个大标题。这是一个简单的label box 并且将字体加大了。

现在保存你的成果:

这个文件在下一部分我们编写代码的时候将会用到,所以最好把它存在一个我们方便访问的地方。

我们创建的只是一个简单的 XML 文件。用任意一个文本编辑器打开它,你可以看到这样的内容:

编写代码

Qt 代码是面向对象的,并且简单易学。所有我们添加的组件都是一个对象,并且都拥有自己的方法比如toPlainText()(用来读取输入框中的值)。这让它使用起来非常方便。

在你编写代码之前,你必须要使用一些函数来进行配置。我确信官方的文档中肯定有提到过这个,但是我现在打死也找不到这些文档了,所以我只能通过官方的例程(以及网上的一些教程)中总结出了这一小段代码来进行配置。我已经把这些函数上传到了 pyqt_skeleton.py

这些代码非常有用,每当你想要创建一个新的 PyQt 项目的时候,就在这段代码的基础上添加你自己的代码吧。

这段代码如下:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
import sys
from PyQt4 import QtCore, QtGui, uic
 
qtCreatorFile = "" # Enter file here.
 
Ui_MainWindow, QtBaseClass = uic.loadUiType(qtCreatorFile)
 
class MyApp(QtGui.QMainWindow, Ui_MainWindow):
    def __init__(self):
        QtGui.QMainWindow.__init__(self)
        Ui_MainWindow.__init__(self)
        self.setupUi(self)
 
if __name__ == "__main__":
    app = QtGui.QApplication(sys.argv)
    window = MyApp()
    window.show()
    sys.exit(app.exec_())

其中需要注意的是第三行:

1
qtCreatorFile = "" # Enter file here.

你需要在这里填入你先前创建的文件的地址。这个文件将会被内置的函数载入:

1
Ui_MainWindow, QtBaseClass = uic.loadUiType(qtCreatorFile)

让我们大致地看一看这段代码:

1
2
3
4
5
if __name__ == "__main__":
    app = QtGui.QApplication(sys.argv)
    window = MyApp()
    window.show()
    sys.exit(app.exec_())

这段主程序创建了一个新的 Qt Gui 应用。,每个 QT 应用都可以通过命令行进行配置,所以必须传入sys.argv 参数。不过现在我们用不到这个。最后,我们创建了一个MyApp 类,这个类继承于 Qt 库并且调用了父类的初始化函数:

1
2
3
4
5
class MyApp(QtGui.QMainWindow, Ui_MainWindow):
    def __init__(self):
        QtGui.QMainWindow.__init__(self)
        Ui_MainWindow.__init__(self)
        self.setupUi(self)

你不一定非得要了解这些代码的细节。你只需要在它的基础上继续开发就好了。

下载pyqt_skeleton.py 这个文件,并将它重命名为pyqt_first.py。这是因为我们不想去改动到源文件。然后要做的第一件事就是在代码中导入我们自己的 XML 文件,这个 XML 文件包含了我们的这个 GUI 信息。将下面的这一行:

1
qtCreatorFile = "" # Enter file here.

替换为

1
qtCreatorFile =  "tax_calc.ui"

这样就能把我们的 GUI 文件载入到内存中。现在,我们的 GUI 中最关键的组件就是我们的这个按钮了。一旦我们按下这个按钮,就会发生一些神奇的事情。到底会发生什么?这就需要我们告诉代码当按下Calculate Tax 按钮的时候该怎么做了。在__init__ 函数中,添加如下的内容:

1
self.calc_tax_button.clicked.connect(self.CalculateTax)

这段代码有什么用?还记得我们把按钮命名为了calc_tax_button 吗?(这是这个按钮对象的名字,不是按钮上显示的提示字符串。)clicked 是一个内置的函数,当有按钮被点击的时候它会被自动调用(很神奇吧)。所有的 QT 组件都有特定的函数,你可以通过 Google 来查看详细。这段代码的最后部分是connect(self.CalculateTax)。这意味着这个按钮会被链接到一个叫做self.CalculateTax 的函数,这样以后每当用户按下这个按钮的时候,这段代码都会被调用。

我们还没有实现这个函数。所以让我们动手开始写吧。

MyApp 类中,添加另外一个函数。我们需要先看看整个函数,然后再去了解它的细节:

1
2
3
4
5
6
def CalculateTax(self):
        price = int(self.price_box.toPlainText())
        tax = (self.tax_rate.value())
        total_price = price  + ((tax / 100) * price)
        total_price_string = "The total price with tax is: " + str(total_price)
        self.results_window.setText(total_price_string)

好了,让我们一行一行的分析上面的代码。

我们现在要做两件事:读取价格和税率,然后计算最终的价格。好了开始吧。请记住,我们要通过我们设定的名字来调用这些组件(这就是我让你不要用默认的通用名称比如box1 的原因,否则的话我们在写代码的时候会很恼火)。

1
price = int(self.price_box.toPlainText())

price_box.toPlainText() 是一个内置的可以读取输入框中的值的函数。顺便提一句,虽然你用得多了以后肯定能记住这些函数,因为他们的名字取得很规范,但是你没必要一开始就去记忆所有这些函数。我每次都是通过 Google 诸如 “Qt Textbox 读取数据”一类的关键字来找到我所需要的函数。

通过函数读取到的是一个 string 类型的值,所以我们需要把他转换成 integer 类型并存在一个price变量中。

然后读取税率:

1
tax = (self.tax_rate.value())

同样的,value() 是读取spinbox 中值的函数。感谢 Google。

我们现在已经得到了以上两个值,这样我们就能用非常高大上的数学公式来计算我们的最终价格了:

1
2
total_price = price  + ((tax / 100) * price)
total_price_string = "The total price with tax is: " + str(total_price)

我们新建了一个 string 变量来储存我们的最终价格。因为最终直接显示在应用上的将会是一个 string 类型的值:

1
self.results_window.setText(total_price_string)

results_window 中,我们调用了setText() 函数,它能显示我们计算出的最终价格的字符串。

最后运行我们写好的程序:

1
python pyqt_first.py

好了,这就是一个简单的 PyQt 教程。

如果你还想要体验更多好玩儿的东西,你可以试着用一用别的组件,不过先提醒一句,你要是放了太多的组件在你的应用中的话,用起来可能会有点费劲…

关于作者: Lane

posted @ 2015-04-28 14:08  juggd  阅读(49176)  评论(1编辑  收藏  举报