欢迎使用wxPython

下面是一个例子,它创建了一个有一个文本框的窗口用来显示鼠标的位置。

   1 #!/bin/env python
   2 import wx
   3 class MyFrame(wx.Frame):
   4 
   5     def __init__(self):
   6         wx.Frame.__init__(self, None, -1, "My Frame", size=(300, 300))
   7         panel = wx.Panel(self, -1)
   8         panel.Bind(wx.EVT_MOTION,  self.OnMove)
   9         wx.StaticText(panel, -1, "Pos:", pos=(10, 12))
  10         self.posCtrl = wx.TextCtrl(panel, -1, "", pos=(40, 10))
  11 
  12     def OnMove(self, event):
  13         pos = event.GetPosition()
  14         self.posCtrl.SetValue("%s, %s" % (pos.x, pos.y))
  15 
  16 if __name__ == '__main__':
  17     app = wx.PySimpleApp()
  18     frame = MyFrame()
  19     frame.Show(True)
  20     app.MainLoop()

图示如下:

w1.1.gif

漂亮的界面是一个GUI程序必不可少的一部分,wxPython可以做到这一点,加之Python强大的功能和简洁的语法,使用得它在Pythongui中成为一种主流。

开始wxPython

首先我们创建一个显示一个图像的文件。这将分三步:

  1. 首先创建一个空的最小的可以工作的wxPthon程序

  2. 组织和细化
  3. 显示wxPythonlogo

图示如下:

w1.2.gif

创建最小的空的wxPython程序

我们创建一个名为bare.py的程序并键入以下代码:

   1 import wx #1
   2 
   3 class App(wx.App):#2
   4 
   5     def OnInit(self): #3
   6         frame = wx.Frame(parent=None, title='Bare')
   7         frame.Show()
   8         return True
   9 
  10 app = App() #4
  11 app.MainLoop() #5

上面的代码运行的结果如下:

w1.5.gif

上面的代码的任何一行都不能少,否则将不能工作。这个基本的wxPython程序说明了开发任一wxPython程序所必须的五个基本步骤:

  1. 导入必须的wxPython

  2. 子类化wxPython应用程序类

  3. 定义一个应用程序的初始化方法
  4. 创建一个应用程序类的实例
  5. 进入这个应用程序的主事件循环

下面让我们看看这个最小的空的程序是如何一步一步实现的。

导入wxPython

你需要做的第一件事就是导入这个主要的wxPython包,这个包名为wx:

   1 import wx

一旦这个包被导入,你就可以引用wxPython的类、函数和常量(它们以wx为前缀),如下所示:

   1 class App(wx.App):

注意:老的引入方式仍然被支持,你可能会遇到用这种老的引入方式的代码。因此我们将会简短地说明这种老的方式及为什么要改变它。老的包的名字是wxPython,它包含了一个内在的名为wx模块。那时,通常有两种导入必要的代码的方法,一种就是从wxPython包中导入wx模块:from wxPython import wx;另一种就是直接从wx模块中导入所有的东西:from wxPython.wx import *。这两种方法都有严重的缺点。这第二种方法Python中是不建议使用的,这因为可能导致名字空间冲突,而老的wx模块通过在其属性前加一个wx前缀避免了这个问题。尽管使用这个安全防范,但是import*仍然有可能导致问题,但是许多wxPython程序员喜欢这种类型,并且你将在老的代码中经常看到这种用法。这种风格的坏处是类名以小写字母开头,而大多数wxPython方法以大写字母开头,这和通常的Python编写程序的习惯相反。

然而如果你试图避免由于使用import*导致的名字空间膨胀,而使用from wxPython import wx。那么你就不得不为每个类、函数、常数名键入两次wx,一次是作为包的前缀,另一次是作为通常的前缀,例如wx.wxWindow

对于导入顺序需要注意的是:你从wxPython导入其它东西之前必须先导入wx。通常情况下,Python中的模块导入顺序无关。但是wxPython中的不同,它是一个复杂的模块。当你第一次导入wx模块时,wxPython要对别的wxPython模块执行一些初始化工作。例如wxPython中的一些子包,如xrc模块,它在wx模块导入之前不能够正确的工作,我们必须按下面顺序导入:

   1 import wx
   2 from wx import xrc

以上的导入顺序只针对wxPython的模块,Python的模块导入顺序没关系。例如:

   1 import sys
   2 import wx
   3 import os
   4 from wx import xrc
   5 import urllib

使用应用程序和框架工作

一旦你导入了wx模块,你就能够创建你的应用程序(application)对象和框架(frame)对象。每个wxPython程序必须有一个application对象和至少一个frame对象。application对象必须是wx.App的一个实例或你在OnInit()方法中定义的一个子类的一个实例。当你的应用程序启动的时候,OnInit()方法将被wx.App父类调用。

子类化wxPython application

下面的代码演示了如何定义我们的wx.App的子类:

   1 class MyApp(wx.App):
   2 
   3     def OnInit(self):
   4         frame = wx.Frame(parent=None, id=-1, title="Bare")
   5         frame.Show()
   6         return True

上面我们定义了一个名为MyApp的子类。我们通常在OnInit()方法中创建frame对象。上面的wx.Frame接受三个参数,仅第一个是必须的,其余的都有默认值。 调用Show()方法使frame可见,否则不可见。我们可以通过给Show()一个布尔值参数来设定frame的可见性:

frame.Show(False)  # 使框架不可见.
frame.Show(True)   # True是默认值,使框架可见.
frame.Hide()       # 等同于frame.Show(False)

定义一个应用程序的初始化方法

注意:我们没有为我们的应用程序类定义一个__init__()方法。在Python中,这就意味着父方法wx.App.__init()__将在对象创建时被自动调用。这是一个好的事情。如果你定义你自己的__init__()方法,不要忘了调用其基类的__init()__方法,示例如下:

   1 class App(wx.App):
   2     def __init__(self):
   3 
   4         wx.App.__init__(self)

如果你忘了这样做,wxPython将不被初始化并且你的OnInit()方法也将得不到调用。

创建一个应用程序实例并进入它的主事件循环

这步是创建wx.App子类的实例,并调用它的MainLoop()方法:

   1 app = App()
   2 app.MainLoop()

一旦进入主事件循环,控制权将转交给wxPythonwxPython GUI程序主要响应用户的鼠标和键盘事件。当一个应用程序的所有框架被关闭后,这个app.MainLoop()方法将返回且程序退出。

扩展这个最小的空的wxPython程序

现在我们将给空的最小程序增加适当数量的功能,它包含了通常Python编程的标准并能够作为你自己的程

序的一个基准。下面我们创建一个名为spare.py程序:

   1 #!/usr/bin/env python   #1
   2 
   3 """Spare.py is a starting point for a wxPython program."""   #2
   4 
   5 import wx
   6 
   7 class Frame(wx.Frame):   #3
   8     pass
   9 
  10 class App(wx.App):
  11 
  12     def OnInit(self):
  13         self.frame = Frame(parent=None, title='Spare')   #4
  14         self.frame.Show()
  15         self.SetTopWindow(self.frame)   #5
  16         return True
  17 
  18 if __name__ == '__main__':   #6
  19     app = App()
  20     app.MainLoop()

这个程序仍然很小,只有14行代码,但是它增加了几个重要的项目让我们考虑到什么样的代码是好的、完整的。

#1 这行看似注释,但是在如linuxunix等操作系统上,它告诉操作系统如何找到执行该程序的解释器。如果这个程序被给予可执行权限(例如使用chmod命令),我们可以在命令行下仅仅键入该程序的名字来运行这个程序:

% spare.py

这行在其它的操作系统上将被忽略。但是包含它可以实现代码的跨平台。

#2 这是文档字符串,当模块中的第一句是字符串的时候,这个字符串就成了该模块的文档字符串并存储

在该模块的__doc__属性中。你能够在你的代码中、某些开发平台、甚至交互模式下运行的Python解释器

中访问文档字符串:

   1     import spare
   2     print spare.__doc__

Spare.py 简单 wxPython 程序的起点。

#3 我们改变了你们创建frame对象的方法。bare版的程序简单地创建了一个wx.Frame类的实例。在spare版中,我们定义了我们自己的Frame类作为wx.Frame的子类。此时,最终的结果没有什么不同,但是如果你想在你的框架中显示诸如文本、按钮、菜单的话,你可能就想要你自己的Frame类了。

#4 我们将对frame实例的引用作为应用程序实例的一个属性

#5OnInit()方法中,我们调用了这个App类自己的SetTopWindow()方法,并传递给它我们新创建的frame实例。我们不必定义SetTopWindow()方法,因为它继承自wx.App父类。SetTopWindow()方法是一个可选的方法,它让wxPython方法知道哪个框架或对话框将被认为是主要的。一个wxPython程序可以有几个框架,其中有一个是被设计为应用程序的顶级窗口的。

#6 这个是Python中通常用来测试该模块是作为程序独立运行还是被另一模块所导入。我们通过检查该模块的__name__属性来实现:

   1 if __name__ == '__main__':
   2    app = App()
   3    app.MainLoop()

创建最终的hello.py程序

代码如下:

   1 #!/usr/bin/env python
   2 
   3 """Hello, wxPython! program."""
   4 
   5 import wx
   6 
   7 
   8 class Frame(wx.Frame):   #2 wx.Frame子类
   9     """Frame class that displays an image."""
  10 
  11     def __init__(self, image, parent=None, id=-1,
  12                  pos=wx.DefaultPosition,
  13                  title='Hello, wxPython!'): #3图像参数
  14         """Create a Frame instance and display image."""
  15 #4 显示图像
  16         temp = image.ConvertToBitmap()
  17         size = temp.GetWidth(), temp.GetHeight()
  18         wx.Frame.__init__(self, parent, id, title, pos, size)
  19         self.bmp = wx.StaticBitmap(parent=self, bitmap=temp)
  20 
  21 class App(wx.App):  #5 wx.App子类
  22     """Application class."""
  23 
  24     def OnInit(self):
  25 #6 图像处理
  26         image = wx.Image('wxPython.jpg', wx.BITMAP_TYPE_JPEG)
  27         self.frame = Frame(image)
  28 
  29         self.frame.Show()
  30         self.SetTopWindow(self.frame)
  31         return True
  32 
  33 def main():  #7
  34     app = App()
  35     app.MainLoop()
  36 
  37 if __name__ == '__main__':
  38      main()

说明:

WxPythonInAction/ChapterOne (last edited 2009-12-25 07:09:09 by localhost)