第一章 欢迎使用wxPython
最后更新于：2022-04-01 22:34:49
# 第一章 欢迎使用wxPython
1. [欢迎使用wxPython](#A.2BayKPzk9.2FdSg-wxPython)
1. [开始wxPython](#A.2BXwBZyw-wxPython)
2. [创建最小的空的wxPython程序](#A.2BUhte.2BmcAXA92hHp6doQ-wxPython.2Begtejw-)
1. [导入wxPython](#A.2BW.2FxRZQ-wxPython)
2. [使用应用程序和框架工作](#A.2BT391KF6UdSh6C16PVIxoRme2XeVPXA-)
3. [扩展这个最小的空的wxPython程序](#A.2BYmlcVY.2FZTipnAFwPdoR6enaE-wxPython.2Begtejw-)
4. [创建最终的hello.py程序](#A.2BUhte.2BmcAfsh2hA-hello.py.2Begtejw-)
下面是一个例子，它创建了一个有一个文本框的窗口用来显示鼠标的位置。
```
#!/bin/env python
import wx
class MyFrame(wx.Frame):
def __init__(self):
wx.Frame.__init__(self, None, -1, "My Frame", size=(300, 300))
panel = wx.Panel(self, -1)
panel.Bind(wx.EVT_MOTION, self.OnMove)
wx.StaticText(panel, -1, "Pos:", pos=(10, 12))
self.posCtrl = wx.TextCtrl(panel, -1, "", pos=(40, 10))
def OnMove(self, event):
pos = event.GetPosition()
self.posCtrl.SetValue("%s, %s" % (pos.x, pos.y))
if __name__ == '__main__':
app = wx.PySimpleApp()
frame = MyFrame()
frame.Show(True)
app.MainLoop()
```
图示如下：
漂亮的界面是一个`GUI`程序必不可少的一部分，`wxPython`可以做到这一点，加之`Python`强大的功能和简洁的语法，使用得它在`Python`的`gui`中成为一种主流。
## 开始wxPython
首先我们创建一个显示一个图像的文件。这将分三步：
1. 首先创建一个空的最小的可以工作的`wxPthon`程序
2. 组织和细化
3. 显示`wxPython`的`logo`
图示如下：
## 创建最小的空的wxPython程序
我们创建一个名为`bare.py`的程序并键入以下代码：
```
import wx #1
class App(wx.App):#2
def OnInit(self): #3
frame = wx.Frame(parent=None, title='Bare')
frame.Show()
return True
app = App() #4
app.MainLoop() #5
```
上面的代码运行的结果如下：
上面的代码的任何一行都不能少，否则将不能工作。这个基本的`wxPython`程序说明了开发任一`wxPython`程序所必须的五个基本步骤：
1. 导入必须的`wxPython`包
2. 子类化`wxPython`应用程序类
3. 定义一个应用程序的初始化方法
4. 创建一个应用程序类的实例
5. 进入这个应用程序的主事件循环
下面让我们看看这个最小的空的程序是如何一步一步实现的。
### 导入wxPython
你需要做的第一件事就是导入这个主要的`wxPython`包，这个包名为`wx:`
```
import wx
```
一旦这个包被导入，你就可以引用`wxPython`的类、函数和常量（它们以`wx`为前缀），如下所示：
```
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`模块导入之前不能够正确的工作，我们必须按下面顺序导入：
```
import wx
from wx import xrc
```
以上的导入顺序只针对`wxPython`的模块，`Python`的模块导入顺序没关系。例如：
```
import sys
import wx
import os
from wx import xrc
import urllib
```
### 使用应用程序和框架工作
一旦你导入了`wx`模块，你就能够创建你的应用程序（`application`）对象和框架（`frame`）对象。每个`wxPython`程序必须有一个`application`对象和至少一个`frame`对象。`application`对象必须是`wx.App`的一个实例或你在`OnInit()`方法中定义的一个子类的一个实例。当你的应用程序启动的时候，`OnInit()`方法将被`wx.App`父类调用。
**子类化`wxPython`** **`application`类**
下面的代码演示了如何定义我们的`wx.App`的子类：
```
class MyApp(wx.App):
def OnInit(self):
frame = wx.Frame(parent=None, id=-1, title="Bare")
frame.Show()
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()__`方法，示例如下：
```
class App(wx.App):
def __init__(self):
wx.App.__init__(self)
```
如果你忘了这样做，`wxPython`将不被初始化并且你的`OnInit()`方法也将得不到调用。
**创建一个应用程序实例并进入它的主事件循环**
这步是创建`wx.App`子类的实例，并调用它的`MainLoop()`方法：
```
app = App()
app.MainLoop()
```
一旦进入主事件循环，控制权将转交给`wxPython`。`wxPython` `GUI`程序主要响应用户的鼠标和键盘事件。当一个应用程序的所有框架被关闭后，这个`app.MainLoop()`方法将返回且程序退出。
## 扩展这个最小的空的wxPython程序
现在我们将给空的最小程序增加适当数量的功能，它包含了通常`Python`编程的标准并能够作为你自己的程
序的一个基准。下面我们创建一个名为`spare.py`程序：
```
#!/usr/bin/env python #1
"""Spare.py is a starting point for a wxPython program.""" #2
import wx
class Frame(wx.Frame): #3
pass
class App(wx.App):
def OnInit(self):
self.frame = Frame(parent=None, title='Spare') #4
self.frame.Show()
self.SetTopWindow(self.frame) #5
return True
if __name__ == '__main__': #6
app = App()
app.MainLoop()
```
这个程序仍然很小，只有14行代码，但是它增加了几个重要的项目让我们考虑到什么样的代码是好的、完整的。
**#1** 这行看似注释，但是在如`linux`和`unix`等操作系统上，它告诉操作系统如何找到执行该程序的解释器。如果这个程序被给予可执行权限（例如使用`chmod`命令），我们可以在命令行下仅仅键入该程序的名字来运行这个程序：
```
% spare.py
```
这行在其它的操作系统上将被忽略。但是包含它可以实现代码的跨平台。
**#2** 这是文档字符串，当模块中的第一句是字符串的时候，这个字符串就成了该模块的文档字符串并存储
在该模块的`__doc__`属性中。你能够在你的代码中、某些开发平台、甚至交互模式下运行的`Python`解释器
中访问文档字符串：
```
import spare
print spare.__doc__
```
`Spare.py` 简单 `wxPython` 程序的起点。
**#3** 我们改变了你们创建`frame`对象的方法。`bare`版的程序简单地创建了一个`wx.Frame`类的实例。在`spare`版中，我们定义了我们自己的`Frame`类作为`wx.Frame`的子类。此时，最终的结果没有什么不同，但是如果你想在你的框架中显示诸如文本、按钮、菜单的话，你可能就想要你自己的`Frame`类了。
**#4** 我们将对`frame`实例的引用作为应用程序实例的一个属性
**#5** 在`OnInit()`方法中，我们调用了这个`App`类自己的`SetTopWindow()`方法，并传递给它我们新创建的`frame`实例。我们不必定义`SetTopWindow()`方法，因为它继承自`wx.App`父类。`SetTopWindow()`方法是一个可选的方法，它让`wxPython`方法知道哪个框架或对话框将被认为是主要的。一个`wxPython`程序可以有几个框架，其中有一个是被设计为应用程序的顶级窗口的。
**#6** 这个是`Python`中通常用来测试该模块是作为程序独立运行还是被另一模块所导入。我们通过检查该模块的`__name__`属性来实现：
```
if __name__ == '__main__':
app = App()
app.MainLoop()
```
## 创建最终的hello.py程序
代码如下：
```
#!/usr/bin/env python
"""Hello, wxPython! program."""
import wx
class Frame(wx.Frame): #2 wx.Frame子类
"""Frame class that displays an image."""
def __init__(self, image, parent=None, id=-1,
pos=wx.DefaultPosition,
title='Hello, wxPython!'): #3图像参数
"""Create a Frame instance and display image."""
#4 显示图像
temp = image.ConvertToBitmap()
size = temp.GetWidth(), temp.GetHeight()
wx.Frame.__init__(self, parent, id, title, pos, size)
self.bmp = wx.StaticBitmap(parent=self, bitmap=temp)
class App(wx.App): #5 wx.App子类
"""Application class."""
def OnInit(self):
#6 图像处理
image = wx.Image('wxPython.jpg', wx.BITMAP_TYPE_JPEG)
self.frame = Frame(image)
self.frame.Show()
self.SetTopWindow(self.frame)
return True
def main(): #7
app = App()
app.MainLoop()
if __name__ == '__main__':
main()
```
说明：
* **#2** 定义一个`wx.Frame`的子类，以便我们更容量控制框架的内容和外观。
**#3** 给我们的框架的构造器增加一个图像参数。这个值通过我们的应用程序类在创建一个框架的实例时提供。同样，我们可以传递必要的值给`wx.Frame.__init__()`
**#4** 我们将用`wx.StaticBitmap`控件来显示这个图像，它要求一个位图。所以我们转换图像到位图。我们也使用图像的宽度和高度创建一个`size`元组。这个`size`元组被提供给`wx.Frame.__init__()`调用，以便于框架的尺寸匹配位图尺寸。
**#5** 定义一个带有`OnInit()`方法的`wx.App`的子类，这是`wxPython`应用程序最基本的要求。
**#6** 我们使用与`hello.py`在同一目录下的名为`wxPython.jpg`的文件创建了一个图像对象。
**#7** `main()`函数创建一个应用程序的实例并启动`wxPython`的事件循环。
';