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