第六章 使用wxPython基本构件
即使是一个简单的wxPython
程序也需要使用标准的元素,诸如菜单和对话框。这儿有对于任一GUI
应用程序的基本的建造部件。使用这些建造部件,还有像启动画面、状态栏或关于框等这些窗口部件,它们给你提供了一个更友好的用户环境,并且给了你的应用程序一个专业的感观。为了要结束本书的第一部分,我们将指导你通过一个程序的创建来使用所有所学的部分。我们将建造一个简单的绘画程序,然后添加这些建造部件元素并说明使用它们时的一些问题。我们将巩固前面章节的基本原理和概念,并且最后我们将产生这个简单但专业的应用程序。本章位于先前基本概念章节和后面对wxPython
功能更详细讨论的2、3部分之间。
我们在本章将建造的这个应用程序基本上基于wxPython
/samples
目录中的涂鸦例子。这个应用程序是一个非常简单的绘画程序,当鼠标左键按下时它跟踪鼠标指针,并画线。图6.1显示了一个简单的初始绘画窗口。
图6.1
我们之所以要选择这样一个绘画例子,是因为它是十分简单的程序,它演示了在创建更复杂的应用程序时所引出的许多问题。在本章,我们将给你展示如何在屏幕上画线、添加状态栏、工具样以及菜单栏。你将会看到如何使用通用对话框,如文件选择器和颜色选择器。我们将使用sizer
来布置窗口部件,并且我们也将增加一个关于框和一个启动画面。本章的最后,你将有一个很好看的绘画程序。
在屏幕上绘画
你的绘画程序的首先的工作是勾画线条并显示出来。像其它的GUI
工具一样, wxPython
提供了一套独立于设备的工具用于绘画。下面,我们将讨论如何在屏幕上绘画。
如何在屏幕上绘画
要在屏幕上绘画,我们要用到一个名为device
context
(设备上下文)的wxPython
对象。设备上下文代表抽象的设备,它对于所有的设备有一套公用的绘画方法,所以对于不同的设备,你的代码是相同的,而不用考虑你所在的具体设备。设备上下文使用抽象的wxPython
的类wx.DC
和其子类来代表。由于wx.DC
是抽象的,所以对于你的应用程序,你需要使用它的子类。
使用设备上下文
表6.1显示了wx.DC
的子类及其用法。设备上下文用来在wxPython
窗口部件上绘画,它应该是局部的,临时性的,不应该以实例变量、全局变量或其它形式在方法调用之间保留。在某些平台上,设备上下文是有限的资源,长期持有wx.DC
可能导致你的程序不稳定。由于wxPython
内部使用设备上下文的方式,对于在窗口部件中绘画,就存在几个有着细微差别的wx.DC
的子类。第十二章将更详细地说明这些差别。
表6.1
wx.BufferedDC
:用于缓存一套绘画命令,直到命令完整并准备在屏幕上绘画。这防止了显示中不必要的闪烁。
wx.BufferedPaintDC
:和wx.BufferedDC
一样,但是只能用在一个wx.PaintEvent
的处理中。仅临时创建该类的实例。
wx.ClientDC
:用于在一个窗口对象上绘画。当你想在窗口部件的主区域上(不包括边框或别的装饰)绘画时使用它。主区域有时也称为客户区。wx.ClientDC
类也应临时创建。该类仅适用于wx.PaintEvent
的处理之外。
wx.MemoryDC
:用于绘制图形到内存中的一个位图中,此时不被显示。然后你可以选择该位图,并使用wx.DC.Blit()
方法来把这个位图绘画到一个窗口中。
wx.MetafileDC
:在Windows
操作系统上,wx.MetafileDC
使你能够去创建标准窗口图元文件数据。
wx.PaintDC
:等同于wx.ClientDC
,除了它仅用于一个wx.PaintEvent
的处理中。仅临时创建该类的实例。
wx.PostScriptDC
:用于写压缩的PostScript
文件。
wx.PrinterDC
:用于Windows
操作系统上,写到打印机。
wx.ScreenDC
:用于直接在屏幕上绘画,在任何被显示的窗口的顶部或外部。该类只应该被临时创建。
wx.WindowDC
:用于在一个窗口对象的整个区域上绘画,包括边框以及那些没有被包括在客户区域中的装饰。非Windows
系统可能不支持该类。
下例6.1包含了显示图6.1的代码。因为该代码展示了基于设备上下文绘画的技巧,所以我们将对其详细注释。
例6.1 初始的SketchWindow
代码
import wx
class SketchWindow(wx.Window):
def __init__(self, parent, ID):
wx.Window.__init__(self, parent, ID)
self.SetBackgroundColour("White")
self.color = "Black"
self.thickness = 1
self.pen = wx.Pen(self.color, self.thickness, wx.SOLID)#1 创建一个wx.Pen对象
self.lines = []
self.curLine = []
self.pos = (0, 0)
self.InitBuffer()
#2 连接事件
self.Bind(wx.EVT_LEFT_DOWN, self.OnLeftDown)
self.Bind(wx.EVT_LEFT_UP, self.OnLeftUp)
self.Bind(wx.EVT_MOTION, self.OnMotion)
self.Bind(wx.EVT_SIZE, self.OnSize)
self.Bind(wx.EVT_IDLE, self.OnIdle)
self.Bind(wx.EVT_PAINT, self.OnPaint)
def InitBuffer(self):
size = self.GetClientSize()
#3 创建一个缓存的设备上下文
self.buffer = wx.EmptyBitmap(size.width, size.height)
dc = wx.BufferedDC(None, self.buffer)
#4 使用设备上下文
dc.SetBackground(wx.Brush(self.GetBackgroundColour()))
dc.Clear()
self.DrawLines(dc)
self.reInitBuffer = False
def GetLinesData(self):
return self.lines[:]
def SetLinesData(self, lines):
self.lines = lines[:]
self.InitBuffer()
self.Refresh()
def OnLeftDown(self, event):
self.curLine = []
self.pos = event.GetPositionTuple()#5 得到鼠标的位置
self.CaptureMouse()#6 捕获鼠标
def OnLeftUp(self, event):
if self.HasCapture():
self.lines.append((self.color,
self.thickness,
self.curLine))
self.curLine = []
self.ReleaseMouse()#7 释放鼠标
def OnMotion(self, event):
if event.Dragging() and event.LeftIsDown():#8 确定是否在拖动
dc = wx.BufferedDC(wx.ClientDC(self), self.buffer)#9 创建另一个缓存的上下文
self.drawMotion(dc, event)
event.Skip()
#10 绘画到设备上下文
def drawMotion(self, dc, event):
dc.SetPen(self.pen)
newPos = event.GetPositionTuple()
coords = self.pos + newPos
self.curLine.append(coords)
dc.DrawLine(*coords)
self.pos = newPos
def OnSize(self, event):
self.reInitBuffer = True #11 处理一个resize事件
def OnIdle(self, event):#12 空闲时的处理
if self.reInitBuffer:
self.InitBuffer()
self.Refresh(False)
def OnPaint(self, event):
dc = wx.BufferedPaintDC(self, self.buffer)#13 处理一个paint(描绘)请求
#14 绘制所有的线条
def DrawLines(self, dc):
for colour, thickness, line in self.lines:
pen = wx.Pen(colour, thickness, wx.SOLID)
dc.SetPen(pen)
for coords in line:
dc.DrawLine(*coords)
def SetColor(self, color):
self.color = color
self.pen = wx.Pen(self.color, self.thickness, wx.SOLID)
def SetThickness(self, num):
self.thickness = num
self.pen = wx.Pen(self.color, self.thickness, wx.SOLID)
class SketchFrame(wx.Frame):
def __init__(self, parent):
wx.Frame.__init__(self, parent, -1, "Sketch Frame",
size=(800,600))
self.sketch = SketchWindow(self, -1)
if __name__ == '__main__':
app = wx.PySimpleApp()
frame = SketchFrame(None)
frame.Show(True)
app.MainLoop()
说明:
#1:wx.Pen
实例决定绘画到设备上下文的线条的颜色、粗细和样式。样式除了wx.SOLID
还有wx.DOT
, wx.LONGDASH
, 和wx.SHORTDASH
。
#2:窗口需要去响应几个不同的鼠标类型事件以便绘制图形。响应的事件有鼠标左键按下和释放、鼠标移动、窗口大小变化和窗口重绘。这里也指定了空闲时的处理。
#3:用两步创建了缓存的设备上下文:(1)创建空的位图,它作为画面外(offscreen)
的缓存(2)使用画面外的缓存创建一个缓存的设备上下文。这个缓存的上下文用于防止我勾画线的重绘所引起的屏幕闪烁。在这节的较后面的部分,我们将更详细地讨论这个缓存的设备上下文。
#4:这几行发出绘制命令到设备上下文;具体就是,设置背景色并清空设备上下文(dc.Clear())
。必须调用dc.Clear()
,其作用是产生一个wx.EVT_PAINT
事件,这样,设置的背景就显示出来了,否则屏幕颜色不会改变。wx.Brush
对象决定了背景的颜色和样式。
#5:事件方法GetPositionTuple()
返回一个包含鼠标敲击的精确位置的Python
元组。
#6:CaptureMouse()
方法控制了鼠标并在窗口的内部捕获鼠标,即使是你拖动鼠标到窗口边框的外面,它仍然只响应窗口内的鼠标动作。在程序的后面必须调用ReleaseMouse()
来取消其对鼠标的控制。否则该窗口将无法通过鼠标关闭等,试将#7注释掉。
#7:ReleaseMouse()
方法将系统返回到调用CaptureMouse()
之前的状态。wxPython
应用程序使用一个椎栈来对捕获了鼠标的窗口的跟踪,调用ReleaseMouse()
相当于从椎栈中弹出。这意味着你需要调用相同数据的CaptureMouse()
和ReleaseMouse()
。
#8:这行确定移动事件是否是线条绘制的一部分,由移动事件发生时鼠标左键是否处于按下状态来确定。Dragging()
和LeftIsDown()
都是wx.MouseEvent
的方法,如果移动事件发生时所关联的条件成立,方法返回true
。
#9:由于wx.BufferedDC
是一个临时创建的设备上下文,所以在我们绘制线条之前需要另外创建一个。这里,我们创建一个新的wx.ClientDC
作为主要的设备上下文,并再次使用我们的实例变量位图作为缓存。
#10:这几行实际是使用设备上下文去绘画新近的勾画线到屏幕上。首先,我们创建了coords
元组,它合并了self.pos
和newPos
元组。这里,新的位置来自于事件GetPositionTuple()
,老的位置是最后对OnMotion()
调用所得到的。我们把该元组保存到self.curLine
列表中,然后调用DrawLine()
。*coords
返回元组coords
中的元素x1
,y1
,x2
,y2
。DrawLine()
方法要求的参数形如x1
,y1
,x2
,y2
,并从点(x1
,y1)
到(x2
,y2)
绘制一条线。勾画的速度依赖于底层系统的速度。
#11:如果窗口大小改变了,我们存储一个True
值到self.reInitBuffer
实例属性中。我们实际上不做任何事直到下一个空闲事件。
#12:当一个空闲产生时,如果已发生了一个或多个尺寸改变事件,这个应用程序抓住时机去响应一个尺寸改变事件。我们存储一个True
值到self.reInitBuffer
实例属性中,并在一个空闲产生时响应的动机是避免对于接二连三的尺寸改变事件都进行屏幕刷新。
#13:对于所有的显示要求,都将产生wx.EVT_PAINT
事件(描绘事件),并调用我们这里的方法OnPaint
进行屏幕刷新(重绘),你可以看到这是出乎意料的简单:创建一个缓存的画图设备上下文。实际上wx.PaintDC
被创建(因为我们处在一个Paint
请求里,所以我们需要wx.PaintDC
而非一个wx.ClientDC
实例),然后在dc
实例被删除后(函数返回时被销毁),位图被一块块地传送(blit)
给屏幕并最终显示。关于缓存的更详细的信息将在随后的段落中提供。
#14:当由于尺寸改变(和由于从文件载入)而导致应用程序需要根据实际数据重绘线条时,被使用。这里,我们遍历存储在实例变量self.lines
中行的列表,为每行重新创建画笔,然后根据坐标绘制每一条线。
这个例子使用了两个特殊的wx.DC
的子类,以使用绘画缓存。一个绘画缓存是一个不显现的区域,其中存储了所有的绘画命令(这些命令能够一次被执行),并且一步到位地复制到屏幕上。缓存的好处是用户看不到单个绘画命令的发生,因此屏幕不会闪烁。正因如此,缓存被普遍地用于动画或绘制是由一些小的部分组成的场合。
在wxPython
中,有两个用于缓存的类:wx.BufferDC
(通常用于缓存一个wx.ClientDC
)、wx.BufferPaintDC
(用于缓存一个wx.PaintDC
)。它们工作方式基本上一样。缓存设备上下文的创建要使用两个参数。第一个是适当类型的目标设备上下文(例如,在例6.1中的#9,它是一个新的wx.ClientDC
实例)。第二个是一个wx.Bitmap
对象。在例6.1中,我们使用函数wx.EmptyBitmap
创建一个位图。当绘画命令到缓存的设备上下文时,一个内在的wx.MemoryDC
被用于位图绘制。当缓存对象被销毁时,C++销毁器使用Blit()
方法去自动复制位图到目标。在wxPython
中,销毁通常发生在对象退出作用域时。这意味缓存的设备上下文仅在临时创建时有用,所以它们能够被销毁并能用于块传送(blit)
。
例如例6.1的OnPaint
()方法中,self.buffer
位图在建造勾画(sketch
)期间已经被写了。只需要创建缓存对象,从而建立关于窗口的已有的位图与临时wx.PaintDC()
之间的连接。方法结束后,缓存DC
立即退出作用域,触发它的销毁器,同时将位图复制到屏幕。
设备上下文的函数
当你使用设备上下文时,要记住根据你的绘制类型去使用恰当的上下文(特别要记住wx.PaintDC
和 wx.ClientDC
的区别)。一旦你有了适当的设备上下文,然后你就可以用它们来做一些事情了。表6.2列出 了wx.DC
的一些方法。
表6.2 wx.DC
的常用方法
Blit(xdest
, ydest
, width
,height
, source
, xsrc
,ysrc)
:从源设备上下文复制块到调用该方法的设备上下文。参数xdest
, ydest
是复制到目标上下文的起始点。接下来的两个参数指定了要复制的区域的宽度和高度。source
是源设备上下文,xsrc
,ysrc
是源设备上下文中开始复制的起点。还有一些可选的参数来指定逻辑叠加功能和掩码。
Clear()
:通过使用当前的背景刷来清除设备上下文。
DrawArc(x1
, y1
, x2
, y2
,xc
, yc)
:使用起点(x1
, y1)
和终点(x2
, y2)
画一个圆弧。(xc
, yc)
是圆弧的中心。圆弧使用当前的画刷填充。这个函数按逆时针画。这也有一个相关的方法DrawEllipticalArc()
。
DrawBitmap(bitmap
, x,y, transparent)
:绘制一个wx.Bitmap
对象,起点为(x, y)
。如果transparent
为真,所复制的位图将是透明的。
DrawCircle(x
, y, radius)
DrawCircle(point
, radius)
:按给定的中心点和半径画圆。这也有一个相关的方法DrawEllipse
。
DrawIcon(icon
, x, y)
:绘制一个wx.Icon
对象到上下文,起点是(x, y)
。
DrawLine(x1
, y1
, x2
, y2)
:从点(x1
, y1)
到(x2
, y2)
画一条线。这有一个相关的方法DrawLines()
,该方法要wx.Point
对象的一个Python
列表为参数,并将其中的点连接起来。
DrawPolygon(points)
:按给定的wx.Point
对象的一个Python
列表绘制一个多边形。与DrawLines()
不同的是,它的终点和起点相连。多边形使用当前的画刷来填充。这有一些可选的参数来设置x和y的偏移以及填充样式。
DrawRectangle(x
, y,width
, height)
:绘制一个矩形,它的左上角是(x, y)
,其宽和高是width
和height
。
DrawText(text
, x, y)
:从点(x, y)
开始绘制给定的字符串,使用当前的字体。相关函数包括DrawRotatedText()
和GetTextExtent()
。文本项有前景色和背景色属性。
FloodFill(x
, y, color
,style)
:从点(x, y)
执行一个区域填充,使用当前画刷的颜色。参数style
是可选的。style
的默认值是wx.FLOOD_SURFACE
,它表示当填充碰到另一颜色时停止。另一值wx.FLOOD_BORDER
表示参数color
是填充的边界,当填充碰到该颜色的代表的边界时停止。
GetBackground()
SetBackground(brush)
:背景画刷是一个wx.Brush
对象,当Clear()
方法被调用时使用。
GetBrush()
SetBrush(brush)
:画刷是一个wx.Brush
对象并且用于填充任何绘制在设备上下文上的形状。
GetFont()
SetFont(font)
:字体(font)
是一个wx.Font
对象,被用于所有的文本绘制操作。
GetPen()
SetPen(pen)
:画笔(pen)
是一个wx.Pen
对象,被用于所有绘制线条的操作。
GetPixel(x
, y)
:返回一个关于点(x, y)
的像素的一个wx.Colour
对象。
GetSize()
GetSizeTuple()
:以一个wx.Size
对象或一个Python
元组的形式返回设备上下文的像素尺寸。
上面的列表并没有囊括所有的方法。另外的一些方法将在第十二章中说明。
添加窗口装饰
尽管绘制到屏幕是一个画图程序不可或缺的部分,但是它距美观的程序还差的远。在这一节,我们将谈及常用的窗口装饰:状态栏、菜单和工具栏。我们将在第10章对这些做更详细的讨论。
如何添加和更新一个状态栏
在wxPython
中,你可以通过调用框架的CreateStatusBar()
方法添加并放置一个状态栏到一个框架的底部。当父框架调整大小的时候,状态栏自动的自我调整大小。默认情况下,状态栏是类wx.StatusBar
的一个实例。要创建一个自定义的状态栏,要使用SetStatusBar()
方法并要求你的新类的实例作为参数来将状态栏附着到你的框架上。
要在你的状态栏上显示单一的一段文本,你可以使用wx.StatusBar
的SetStatusText()
方法。例6.2扩展了在例6.1中所演示的SketchFrame
类来在状态栏中显示当前鼠标的位置。
例6.2 给框架添加一个简单的状态栏
# python
import wx from example1 import SketchWindow
class SketchFrame(wx.Frame):
def init(self, parent):
wx.Frame.init(self, parent, -1, "Sketch Frame",
size=(800,600))
self.sketch = SketchWindow(self, -1)
self.sketch.Bind(wx.EVT_MOTION, self.OnSketchMotion)
self.statusbar = self.CreateStatusBar()
def OnSketchMotion(self, event):
self.statusbar.SetStatusText(str(event.GetPositionTuple()))
event.Skip()
if name == 'main':
app = wx.PySimpleApp()
frame = SketchFrame(None)
frame.Show(True)
app.MainLoop()
我们通过使框架捕捉勾画窗的wx.EVT_MOTION
事件来在状态栏中显示鼠标位置。事件处理器使用由该事件提供的数据设置状态栏的文?尽H缓蟮饔脅方法来保证另外的OnMotion()
方法被调用,否则线条将不被绘制。
如果你想在状态栏中显示多个文本元素,你可以在状态栏中创建多个文本域。要使用这个功能,你要调用SetFieldsCount()
方法,其参数是域的数量;默认情况下只有我们先前所见的那一个域。这之后使用先前的SetStatusText()
,但是要使用第二个参数来指定此方法所应的域。域的编号从0开始。如果你不指定一个域,那么默认为设置第0号域,这也说明了为什么我们没有指定域而先前的例子能工作。
默认情况下,每个域的宽度是相同的。要调整文本域的尺寸,wxPython
提供了SetStatusWidth()
方法。该方法要求一个整数的Python
列表作为参数,列表的长度必须和状态栏中哉的数量一致。按列表中整数的顺序来计算对应域的宽度。如果整数是正值,那么宽度是固定的。如果你想域的宽度随框架的变化而变化,那么应该使用负值。负值的绝对值代表域的相对宽度;可以把它认为是所占总宽度的比例。例如调用statusbar.SetStatusWidth(
[-1, -2,-3])方法所导致的各域从左到右的宽度比例是1:2:3。图6.2显示了这个结果。
图6.2
例子6.3增加了两个状态域,其中一个显示所绘的当前线条的点数,另一个显示当前所画的线条的数量。该例所产生的状态条如图6.2所示。
例6.3 支持多个状态域
import wx
from example1 import SketchWindow
class SketchFrame(wx.Frame):
def __init__(self, parent):
wx.Frame.__init__(self, parent, -1, "Sketch Frame",
size=(800,600))
self.sketch = SketchWindow(self, -1)
self.sketch.Bind(wx.EVT_MOTION, self.OnSketchMotion)
self.statusbar = self.CreateStatusBar()
self.statusbar.SetFieldsCount(3)
self.statusbar.SetStatusWidths([-1, -2, -3])
def OnSketchMotion(self, event):
self.statusbar.SetStatusText("Pos: %s" %
str(event.GetPositionTuple()), 0)
self.statusbar.SetStatusText("Current Pts: %s" %
len(self.sketch.curLine), 1)
self.statusbar.SetStatusText("Line Count: %s" %
len(self.sketch.lines), 2)
event.Skip()
if __name__ == '__main__':
app = wx.PySimpleApp()
frame = SketchFrame(None)
frame.Show(True)
app.MainLoop()
StatusBar
类使你能够把状态域当作一个后进先出的堆栈。尽管本章的演示程序没有这样用,PushStatus
- Text()
和PopStatusText()
使得你能够在临时显示新的文本之后返回先前的状态文本。这两个方法都有一个可选的域号参数,以便在多个状态域的情况下使用。
表6.3归纳了wx.StatusBar
最常用的方法
表6.3 wx.StatusBar
的方法
GetFieldsCount()
SetFieldsCount(count)
:得到或设置状态栏中域的数量。
GetStatusText(field
=0) SetStatusText(text
, field
=0):得到或设置指定域中的文本。0是默认值,代表最左端的域。
PopStatusText(field
=0):弹出堆栈中的文本到指定域中,以改变域中的文本为弹出值。
PushStatusText(text
, field
=0):改变指定的域中的文本为给定的文本,并将改变前的文本压入堆栈的顶部。
SetStatusWidths(widths)
:指定各状态域的宽度。widths
是一个整数的Python
列表。
在第10章中,我们将对状态栏作更详细的说明。下面我们将讨论菜单。
如何添加菜单?
本节,我们将说明如何添加子菜单和复选或单选菜单。子菜单是顶级菜单中的菜单。复制菜单或单选菜单是一组菜单项,它们的行为类似于一组复选框或单选按钮。图6.3显示了一个菜单栏,其中的一个子菜单包含了单选菜单项。
图6.3
要创建一个子菜单,首先和创建别的菜单方法一样创建一个菜单,然后再使用wx.Menu.AppendMenu()
将它添加给父菜单。
带有复选或单选菜单的菜单可以通过使用wx.Menu
的AppendCheckItem()
和AppendRadioItem()
方法来创建,或通过在wx.MenuItem
的创建器中使参数kind
的属性值为下列之一来创建:wx.ITEM_NORMAL
, wx.ITEM_CHECKBOX
, 或 wx.ITEM_RADIO
。要使用编程的方法来选择一个菜单项,可以使wx.Menu
的Check(id
,bool)
方法,id
是所要改变项的wxPython
ID
,bool
指定了该项的选择状态。
例6.4为我们初始的绘画程序添加了菜单支持。我们这里的菜单改进自例5.5中的被重构的公用程序代码。
例子6.4
import wx
from example1 import SketchWindow
class SketchFrame(wx.Frame):
def __init__(self, parent):
wx.Frame.__init__(self, parent, -1, "Sketch Frame",
size=(800,600))
self.sketch = SketchWindow(self, -1)
self.sketch.Bind(wx.EVT_MOTION, self.OnSketchMotion)
self.initStatusBar() #1 这里因重构有点变化
self.createMenuBar()
def initStatusBar(self):
self.statusbar = self.CreateStatusBar()
self.statusbar.SetFieldsCount(3)
self.statusbar.SetStatusWidths([-1, -2, -3])
def OnSketchMotion(self, event):
self.statusbar.SetStatusText("Pos: %s" %
str(event.GetPositionTuple()), 0)
self.statusbar.SetStatusText("Current Pts: %s" %
len(self.sketch.curLine), 1)
self.statusbar.SetStatusText("Line Count: %s" %
len(self.sketch.lines), 2)
event.Skip()
def menuData(self): #2 菜单数据
return [(" ", (
(" ", "New Sketch file", self.OnNew),
(" ", "Open sketch file", self.OnOpen),
(" ", "Save sketch file", self.OnSave),
("", "", ""),
(" ", (
(" ", "", self.OnColor,
wx.ITEM_RADIO),
(" ", "", self.OnColor,
wx.ITEM_RADIO),
(" ", "", self.OnColor,
wx.ITEM_RADIO),
(" ", "", self.OnColor,
wx.ITEM_RADIO))),
("", "", ""),
(" ", "Quit", self.OnCloseWindow)))]
def createMenuBar(self):
menuBar = wx.MenuBar()
for eachMenuData in self.menuData():
menuLabel = eachMenuData[0]
menuItems = eachMenuData[1]
menuBar.Append(self.createMenu(menuItems), menuLabel)
self.SetMenuBar(menuBar)
def createMenu(self, menuData):
menu = wx.Menu()
#3 创建子菜单
for eachItem in menuData:
if len(eachItem) == 2:
label = eachItem[0]
subMenu = self.createMenu(eachItem[1])
menu.AppendMenu(wx.NewId(), label, subMenu)
else:
self.createMenuItem(menu, *eachItem)
return menu
def createMenuItem(self, menu, label, status, handler,
kind=wx.ITEM_NORMAL):
if not label:
menu.AppendSeparator()
return
menuItem = menu.Append(-1, label, status, kind)#4 使用kind创建菜单项
self.Bind(wx.EVT_MENU, handler, menuItem)
def OnNew(self, event): pass
def OnOpen(self, event): pass
def OnSave(self, event): pass
def OnColor(self, event):#5 处理颜色的改变
menubar = self.GetMenuBar()
itemId = event.GetId()
item = menubar.FindItemById(itemId)
color = item.GetLabel()
self.sketch.SetColor(color)
def OnCloseWindow(self, event):
self.Destroy()
if __name__ == '__main__':
app = wx.PySimpleApp()
frame = SketchFrame(None)
frame.Show(True)
app.MainLoop()
说明:
#1:现在__init__
方法包含了更多的功能,我们把状态栏放在了它自己的方法中。
#2:菜单数据的格式现在是(标签, (项目)),其中的每个顶目也是一个列表(标签, 描术文字, 处理器, 可选的kind)
或一个带有标签和项目的菜单。确定数据的一个子项目是菜单还是一个菜单项,请记住,菜单的长度是2,项目的长度是3或4。对于更复杂的产品数据,我建议使用XML
或别的外部格式。
#3:如果数据块的长度是2,这意味它是一个菜单,将之分开,并递归调用createMenu
,然后将之添加。
#4:创建菜单项。对wx.MenuItem
的构造器使用kind
参数的方法比使用wx.Menu
的特定方法更容易。
#5:OnColor
方法根据所选菜单项来改变画笔的颜色。代码根据事件得到项目的id
,再使用FindItemById()
来得到正确的菜单项(注意我们这里使用菜单栏作为数据结构来访问,而没有使用项目id
的哈希表),这个方法是以标签是wxPython
颜色名为前提的。
如何添加一个工具栏
菜单栏和工具栏通常是紧密联系在一起的,工具栏的绝大部分功能与菜单项相对应。在wxPython
中,这通过工具栏被敲击时发出wx.EVT_MENU
事件,这样就可很容易地在处理菜单项的选择和工具栏的敲击时使用相同的方法。一个wxPython
工具栏是类wx.ToolBar
的一个实例,正如我们在第二章中所见的,可以使用框架的方法CreateToolBar()
来创建。和状态栏一样,工具栏的大小也随其父框架的改变而自动改变。工具栏与其它的wxPython
窗口一样可以拥有任意的子窗口。工具栏也包含创建工具按钮的方法。图6.4显示了带有一个工具栏的sketch
窗口的一部分,这个工具栏使用了6.2.2中菜单的相应方法,以与菜单项的功能相对应。
图6.4
例6.5中,我们没有重复使用菜单改变画笔颜色的代码,而是使用了新的方法。
例6.5 添加一个工具栏到sketch
应用程序
def __init__(self, parent):
wx.Frame.__init__(self, parent, -1, "Sketch Frame",size=(800,600))
self.sketch = SketchWindow(self, -1)
self.sketch.Bind(wx.EVT_MOTION, self.OnSketchMotion)
self.initStatusBar()
self.createMenuBar()
self.createToolBar()
def createToolBar(self):#1创建工具栏
toolbar = self.CreateToolBar()
for each in self.toolbarData():
self.createSimpleTool(toolbar, *each)
toolbar.AddSeparator()
for each in self.toolbarColorData():
self.createColorTool(toolbar, each)
toolbar.Realize()#2 显现工具栏
def createSimpleTool(self, toolbar, label, filename,help, handler):#3 创建常规工具
if not label:
toolbar.AddSeparator()
return
bmp = wx.Image(filename,wx.BITMAP_TYPE_BMP).ConvertToBitmap()
tool = toolbar.AddSimpleTool(-1, bmp, label, help)
self.Bind(wx.EVT_MENU, handler, tool)
def toolbarData(self):
return (("New", "new.bmp", "Create new sketch",self.OnNew),
("", "", "", ""),
("Open", "open.bmp", "Open existing sketch",self.OnOpen),
("Save", "save.bmp", "Save existing sketch",self.OnSave))
def createColorTool(self, toolbar, color):#4 创建颜色工具
bmp = self.MakeBitmap(color)
newId = wx.NewId()
tool = toolbar.AddRadioTool(-1, bmp, shortHelp=color)
self.Bind(wx.EVT_MENU, self.OnColor, tool)
def MakeBitmap(self, color):#5 创建纯色的位图
bmp = wx.EmptyBitmap(16, 15)
dc = wx.MemoryDC()
dc.SelectObject(bmp)
dc.SetBackground(wx.Brush(color))
dc.Clear()
dc.SelectObject(wx.NullBitmap)
return bmp
def toolbarColorData(self):
return ("Black", "Red", "Green", "Blue")
def OnColor(self, event):#6 改变画笔颜色以响应工具栏的敲击
menubar = self.GetMenuBar()
itemId = event.GetId()
item = menubar.FindItemById(itemId)
if not item:
toolbar = self.GetToolBar()
item = toolbar.FindById(itemId)
color = item.GetShortHelp()
else:
color = item.GetLabel()
self.sketch.SetColor(color)
#1:工具栏的代码在设置上类似于菜单代码。然而,这里,我们对常规的按钮和单选切换按钮使用了不同的循环设置。
#2:Realize()
方法实际上是在工具栏中布局工具栏对象。它在工具栏被显示前必须被调用,如果工具栏中的添加或删除了工具,那么这个方法也必须被调用。
#3:这个方法类似于菜单项的创建。主要区别是工具栏上的工具要求显示位图。这里我们使用了三个位于同一目录下基本位图。在该方法的最后,我们绑定了菜单项所使用的相同的wx.EVT_MENU
事件。
#4:颜色工具的创建类似于常规的工具。唯一的不同是使用了一个不同的方法去告诉工具栏它们是单选工具。纯色的位图由MakeBitmap()
方法创建。
#5:该方法为单选工具创建纯色的位图。
#6:该方法在原有的基础上添加了搜索正确的工具以具此来改变颜色。然而,所写的代码的问题是,通过菜单项使画笔颜色改变了,但是工具栏上的单选工具的状态没有相应改变,反过来也是一样。
工具栏中的工具在鼠标右键敲击时能够产生wx.EVT_TOOL_RCLICKED
类型事件。工具栏也有一些不同的样式,它们被作为位图参数传递给CreateToolBar()
。表6.4列出了一些工具栏的样式。
表6.4 wx.ToolBar
类的样式
wx.TB_3DBUTTONS
:3D外观
wx.TB_HORIZONTAL
:默认样式,工具栏水平布置
wx.TB_NOICONS
:不为每个工具显示位图
wx.TB_TEXT
:根据不同的位图显示简短的帮助文本
wx.TB_VERTICAL
:垂直放置工具栏
工具栏比状态栏更复杂。表6.5显示了其常用的一些方法。
表6.5 wx.ToolBar
的常用方法
AddControl(control)
:添加一个任意的wxPython
控件到工具栏。相关方法InsertControl()
。
AddSeparator()
:在工具之间放置空格。
AddSimpleTool(id
, bitmap
,shortHelpString
="",kind
=wx.ITEM_NORMAL)
:添加一个简单的带有给定位图的工具到工具栏。shortHelpString
作为提示显示。kind
的值可以是wx.ITEM_NORMAL
, wx.ITEM_CHECKBOX
, 或wx.ITEM_RADIO
。
AddTool(id
, bitmap
,bitmap2
=wx.NullBitmap
,kind
=wx.ITEM_NORMAL
,shortHelpString
="",longHelpString
="", clientData
=None)
:简单工具的其它参数。bitmap2
是当该工具被按下时所显示的位图。longHelpString
是当指针位于该工具中时显示在状态栏中的帮助字符串。clientData
用于将任意的一块数据与工具相联系起来。相关方法InsertTool()
。
AddCheckTool(...)
:添加一个复选框切换工具,所要求参数同AddTool()
。
AddRadioTool(...)
:添加一个单选切换工具,所要求参数同AddTool()
。对于连续的未分隔的单选工具被视为一组。
DeleteTool(toolId)
DeleteToolByPosition(x
, y)
:删除所给定的id
的工具,或删除给定显示位置的工具。
FindControl(toolId)
FindToolForPosition(x
, y)
:查找并返回给定id
或显示位置的工具。
ToggleTool(toolId
, toggle)
:根据布尔什toggle
来设置给定id
的工具的状态。
下一节,我们将给你展示如何使用通用对话框来得到用户的信息。
得到标准信息
你的应用程序经常需要从用户那里得到基本的信息,这通常通过对话框。在这一节,我们将讨论针对标准用户信息的标准文件和颜色对话框。
如何使用标准文件对话框?
大部分的GUI
应用程序都要保存和载入这样那样的数据。考虑到你和你的用户,应该有一个简单的,方便的机制来选择文件。很高兴,为此wxPython
提供了标准的文件对话框wx.FileDialog
。图6.5显示了这个用于sketch
程序的文件对话框。
wx.FileDialog
最重要的方法是它的构造器,语法如下:
wx.FileDialog(parent
, message
="Choose
a file
", defaultDir
="", defaultFile
="", wildcard
=".", style
=0)
表6.6对构造器的参数进行了说明。
表6.6 wx.FileDialog
构造器的参数
parent
:对话框的父窗口。如果没有父窗口则为None
。
message
:message
显示在对话框的标题栏中。
defaultDir
:当对话框打开时,默认的目录。如果为空,则为当前工作目录。
defaultFile
:当对话框打开时,默认选择的文件。如果为空,则没有文件被选择。
wildcard
:通配符。指定要选择的文件类型。格式是 display
| wildcard
。可以指定多种类型的文件,例如:“Sketch
files
(.sketch)
|.sketch
|All
files
(.)|.”。
style
:样式。见下表6.7。
表6.7 wx.FileDialog
的样式
wx.CHANGE_DIR
:在用户选择了一个文件之后,当前工作目录相应改变到所选文件所在的目录。
wx.MULTIPLE
:仅适用于打开对话框。这个样式使得用户可以选择多个文件。
wx.OPEN
:这个样式用于打开一个文件。
wx.OVERWRITE_PROMPT
:仅适用于保存文件对话框。显示一个提示信息以确认是否覆盖一个已存在的文件。
wx.SAVE
:这个样式用于保存一个文件。
要使用文件对话框,要对一个对话框实例调用ShowModal()
方法。这个方法根据用户所敲击的对话框上的按钮来返回wx.ID_OK
或wx.ID_CANCEL
。选择之后。使用GetFilename()
, GetDirectory()
, 或GetPath()
方法来获取数据。之后,调用Destroy()
销毁对话框是一个好的观念。
下例6.6显了对SketchFrame
所作的修改以提供保存和装载(完整的附书源码请到论坛的"相关资源"的"教程下载"中下载)。这些改变要求导入cPickle
和os
模块。我们使用cPickle
来将数据的列表转换为可用于文件读写的数据格式。
例6.6 SketchFrame
的保存和装载方法
def __init__(self, parent):
self.title = "Sketch Frame"
wx.Frame.__init__(self, parent, -1, self.title,size=(800,600))
self.filename = ""
self.sketch = SketchWindow(self, -1)
self.sketch.Bind(wx.EVT_MOTION, self.OnSketchMotion)
self.initStatusBar()
self.createMenuBar()
self.createToolBar()
def SaveFile(self):#1 保存文件
if self.filename:
data = self.sketch.GetLinesData()
f = open(self.filename, 'w')
cPickle.dump(data, f)
f.close()
def ReadFile(self):#2 读文件
if self.filename:
try:
f = open(self.filename, 'r')
data = cPickle.load(f)
f.close()
self.sketch.SetLinesData(data)
except cPickle.UnpicklingError:
wx.MessageBox("%s is not a sketch file." % self.filename, "oops!",
style=wx.OK|wx.ICON_EXCLAMATION)
wildcard = "Sketch files (*.sketch)|*.sketch|All files (*.*)|*.*"
def OnOpen(self, event):#3 弹出打开对话框
dlg = wx.FileDialog(self, "Open sketch file...",os.getcwd(), style=wx.OPEN,wildcard=self.wildcard)
if dlg.ShowModal() == wx.ID_OK:
self.filename = dlg.GetPath()
self.ReadFile()
self.SetTitle(self.title + ' -- ' + self.filename)
dlg.Destroy()
def OnSave(self, event):#4 保存文件
if not self.filename:
self.OnSaveAs(event)
else:
self.SaveFile()
def OnSaveAs(self, event):#5 弹出保存对话框
dlg = wx.FileDialog(self, "Save sketch as...",
os.getcwd(),
style=wx.SAVE | wx.OVERWRITE_PROMPT,
wildcard=self.wildcard)
if dlg.ShowModal() == wx.ID_OK:
filename = dlg.GetPath()
if not os.path.splitext(filename)[1]:#6 确保文件名后缀
filename = filename + '.sketch'
self.filename = filename
self.SaveFile()
self.SetTitle(self.title + ' -- ' +
self.filename)
dlg.Destroy()
#1:该方法写文件数据到磁盘中,给定了文件名,使用了cPickle
模块。
#2:该方法使用cPickle
来读文件。如果文件不是期望的类型,则弹出一个消息框来警告。
#3:OnOpen()
方法使用wx.OPEN
样式来创建一个对话框。通配符让用户可以限定选择.sketch
文件。如果用户敲击OK
,那么该方法根据所选择的路径调用ReadFile()
方法。
#4:如果已经选择了用于保存当前数据的文件名,那么保存文件,否则,我们打开保存对话框。
#5:OnSave()
方法创建一个wx.SAVE
文件对话框。
#6:这行确保文件名后缀为.sketch
。
下一节,我们将讨论如何使用文件选择器。
如何使用标准的颜色选择器?
如果用户能够在sketch
对话框中选择任意的颜色,那么这将是有用。对于这个目的,我们可以使用wxPython
提供的标准wx.ColourDialog
。这个对话框的用法类似于文件对话框。它的构造器只需要一个parent(
双亲)和一个可选的数据属性参数。数据属性是一个wx.ColourData
的实例,它存储与该对话框相关的一些数据,如用户选择的颜色,还有自定义的颜色的列表。使用数据属性使你能够在以后的应用中保持自定义颜色的一致性。
在sketch
应用程序中使用颜色对话框,要求增加一个菜单项和一个处理器方法。例6.7显示了所增加的代码。
例6.7 对SketchFrame
做一些改变,以显示颜色对话框
def menuData(self):
return [(" ", (
(" ", "New Sketch file", self.OnNew),
(" ", "Open sketch file", self.OnOpen),
(" ", "Save sketch file", self.OnSave),
("", "", ""),
(" ", (
(" ", "", self.OnColor,wx.ITEM_RADIO),
(" ", "", self.OnColor,wx.ITEM_RADIO),
(" ", "", self.OnColor,wx.ITEM_RADIO),
(" ", "", self.OnColor,wx.ITEM_RADIO),
(" ", "", self.OnOtherColor,wx.ITEM_RADIO))),
("", "", ""),
(" ", "Quit", self.OnCloseWindow)))]
def OnOtherColor(self, event):
dlg = wx.ColourDialog(self)
dlg.GetColourData().SetChooseFull(True)# 创建颜色数据对象
if dlg.ShowModal() == wx.ID_OK:
self.sketch.SetColor(dlg.GetColourData().GetColour())# 根据用户的输入设置颜色
dlg.Destroy()
颜色数据实例的SetChooseFull()
方法告诉对话框去显示整个调色板,其中包括了自定义的颜色信息。对话框关闭后,我们根据得到的颜色来拾取颜色数据。颜色数据作为一个wx.Color
的实例返回并传递给sketch
程序来设置颜色。
给应用程序一个好看的外观
在这一节中,我们将讨论如何让你的程序有一个好的外观。从重要性来说,储如你如何作安排以便用户调整窗口的大小,从细节来说,储如你如何显示一个about
框。在本书的第二部分,我们将更详细地对这些主题进行进一步的讨论。
如何布局窗口部件?
在你的wxPython
应用程序中布局你的窗口部件的方法之一是,在每个窗口部件被创建时显式地指定它的位置和大小。虽然这个方法相当地简单,但是它一直存在几个缺点。其中之一就是,因为窗口部件的尺寸和默认字体的尺寸不同,对于在所有系统上要得到一个正确的定位是非常困难的。另外,每当用户调整父窗口的大小时,你必须显式地改变每个窗口部件的定位,要正确地实现它是十分痛苦的。
幸运的是,这儿有一个更好的方法。在wxPython
中的布局机制是一个被称为sizer
的东西,它类似于Java
AWT
和其它的界面工具包中的布局管理器。每个不同的sizer
基于一套规则管理它的窗口的尺寸和位置。sizer
属于一个容器窗口(比如wx.Panel
)。在父中创建的子窗口必须被添加给sizer
,sizer
管理每个窗口部件的尺寸和位置。
创建一个sizer
创建一个sizer
的步骤:
1、创建你想用来自动调用尺寸的panel
或container(
容器)。 2、创建sizer
。 3、创建你的子窗口。 4、使用sizer
的Add()
方法来将每个子窗口添加给sizer
。当你添加窗口时,给了sizer
附加的信息,这包括窗口周围空间的度量、在由sizer
所管理分配的空间中如何对齐窗口、当容器窗口改变大小时如何扩展子窗口等。 5、sizer
可以嵌套,这意味你可以像窗口对象一样添加别的sizer
到父sizer
。你也可以预留一定数量的空间作为分隔。 6、调用容器的SetSizer(sizer)
方法。
表6.8列出了在wxPython
中有效的最常用的sizer
。对于每个专门的sizer
的更完整的说明见第11章。
表6.8 最常用的wxPython
的sizer
wx.BoxSizer
:在一条线上布局子窗口部件。wx.BoxSizer
的布局方向可以是水平或坚直的,并且可以在水平或坚直方向上包含子sizer
以创建复杂的布局。在项目被添加时传递给sizer
的参数控制子窗口部件如何根据box
的主体或垂直轴线作相应的尺寸调整。
wx.FlexGridSizer
:一个固定的二维网格,它与wx.GridSizer
的区别是,行和列根据所在行或列的最大元素分别被设置。
wx.GridSizer
:一个固定的二维网格,其中的每个元素都有相同的尺寸。当创建一个grid
sizer
时,你要么固定行的数量,要么固定列的数量。项目被从左到右的添加,直到一行被填满,然后从下一行开始。
wx.GridBagSizer
:一个固定的二维网格,基于wx.FlexGridSizer
。允许项目被放置在网格上的特定点,也允许项目跨越多和网格区域。
wx.StaticBoxSizer
:等同于wx.BoxSizer
,只是在box
周围多了一个附加的边框(有一个可选的标签)。
使用sizer
为了演示sizer
的用法,我们将给sketch
应用程序增加一个control
panel
。control
panel
包含用来设置线条颜色和粗细的按钮。这个例子使用了wx.GridSizer
(用于按钮)和wx.BoxSizer
(用于其余的布局部分)。图6.6显示了使用了panel
的sketch
应用程序,并图解了grid
和box
的实际布局。
例6.8显示了实现control
panel
而对sketch
程序所作的必要的改变。在这一节,我们的讨论将着重于sizer
的实现。
例6.8
def __init__(self, parent):
self.title = "Sketch Frame"
wx.Frame.__init__(self, parent, -1, self.title, size=(800,600))
self.filename = ""
self.sketch = SketchWindow(self, -1)
self.sketch.Bind(wx.EVT_MOTION, self.OnSketchMotion)
self.initStatusBar()
self.createMenuBar()
self.createToolBar()
self.createPanel()
def createPanel(self):
controlPanel = ControlPanel(self, -1, self.sketch)
box = wx.BoxSizer(wx.HORIZONTAL)
box.Add(controlPanel, 0, wx.EXPAND)
box.Add(self.sketch, 1, wx.EXPAND)
self.SetSizer(box)
在例6.8中,createPanel()
方法创建了ControlPanel
(在下面的列表中说明)的实例,并且与box
sizer
放在一起。wx.BoxSizer
的构造器的唯一参数是方向,取值可以是wx.HORIZONTAL
或wx.VERTICAL
。接下来,这个新的controlPanel
和先前创建的SketchWindow
被使用Add()
方法添加给了sizer
。第一个参数是要被添加给sizer
的对象。第二个参数是被wx.BoxSizer
用作因数去决定当sizer
的大小改变时,sizer
应该如何调整它的孩子的尺寸。我们这里使用的是水平方向调整的sizer
,stretch
因数决定每个孩子的水平尺寸如何改变(坚直方向的改变由box
sizer
基于第三个参数来决定)。
如果第二个参数(stretch
因数)是0,对象将不改变尺寸,无论sizer
如何变化。如果第二个参数大于0,则sizer
中的孩子根据因数分割sizer
的总尺寸(类似于wx.StatusBar
管理文本域的宽度的做法)。如果sizer
中的所有孩子有相同的因数,那么它们按相同的比例分享放置了固定尺寸的元素后剩下的空间。这里的0表示假如用户伸展框架时,controlPanel
不改变水平的尺寸,而1表示绘画窗口(sketch
window
)的尺寸要随框架的改变而改变。
Add()
的第三个参数是另一个位掩码标志。完整的说明将在以后的章节中给出。wx.EXPAND
指示sizer
调整孩子的大小以完全填满有效的空间。其它的可能的选项允许孩子被按比例的调整尺寸或根据sizer
的特定部分对齐。图6.7将帮助阐明参数及其控制的调整尺寸的方向。
这些设置的结果是当你运行这个带有box
sizer
的框架的时候,任何在水平方向的改变都将导致sketch
window
的尺寸在该方向?系母谋洌瑊 panel
不会在该方向上改变。在坚直方向的尺寸改变导致这两个子窗口都要在坚直方向缩放。
例6.8中涉及的类ControlPanel
结合使用了grid
和box
sizer
。例6.9包含了这个类的代码。
例6.9 ControlPanel
类
class ControlPanel(wx.Panel):
BMP_SIZE = 16
BMP_BORDER = 3
NUM_COLS = 4
SPACING = 4
colorList = ('Black', 'Yellow', 'Red', 'Green', 'Blue', 'Purple',
'Brown', 'Aquamarine', 'Forest Green', 'Light Blue',
'Goldenrod', 'Cyan', 'Orange', 'Navy', 'Dark Grey',
'Light Grey')
maxThickness = 16
def __init__(self, parent, ID, sketch):
wx.Panel.__init__(self, parent, ID, style=wx.RAISED_BORDER)
self.sketch = sketch
buttonSize = (self.BMP_SIZE + 2 * self.BMP_BORDER,
self.BMP_SIZE + 2 * self.BMP_BORDER)
colorGrid = self.createColorGrid(parent, buttonSize)
thicknessGrid = self.createThicknessGrid(buttonSize)
self.layout(colorGrid, thicknessGrid)
def createColorGrid(self, parent, buttonSize):#1 创建颜色网格
self.colorMap = {}
self.colorButtons = {}
colorGrid = wx.GridSizer(cols=self.NUM_COLS, hgap=2, vgap=2)
for eachColor in self.colorList:
bmp = parent.MakeBitmap(eachColor)
b = buttons.GenBitmapToggleButton(self, -1, bmp, size=buttonSize)
b.SetBezelWidth(1)
b.SetUseFocusIndicator(False)
self.Bind(wx.EVT_BUTTON, self.OnSetColour, b)
colorGrid.Add(b, 0)
self.colorMap[b.GetId()] = eachColor
self.colorButtons[eachColor] = b
self.colorButtons[self.colorList[0]].SetToggle(True)
return colorGrid
def createThicknessGrid(self, buttonSize):#2 创建线条粗细网格
self.thicknessIdMap = {}
self.thicknessButtons = {}
thicknessGrid = wx.GridSizer(cols=self.NUM_COLS, hgap=2, vgap=2)
for x in range(1, self.maxThickness + 1):
b = buttons.GenToggleButton(self, -1, str(x), size=buttonSize)
b.SetBezelWidth(1)
b.SetUseFocusIndicator(False)
self.Bind(wx.EVT_BUTTON, self.OnSetThickness, b)
thicknessGrid.Add(b, 0)
self.thicknessIdMap[b.GetId()] = x
self.thicknessButtons[x] = b
self.thicknessButtons[1].SetToggle(True)
return thicknessGrid
def layout(self, colorGrid, thicknessGrid):#3 合并网格
box = wx.BoxSizer(wx.VERTICAL)
box.Add(colorGrid, 0, wx.ALL, self.SPACING)
box.Add(thicknessGrid, 0, wx.ALL, self.SPACING)
self.SetSizer(box)
box.Fit(self)
def OnSetColour(self, event):
color = self.colorMap[event.GetId()]
if color != self.sketch.color:
self.colorButtons[self.sketch.color].SetToggle(False)
self.sketch.SetColor(color)
def OnSetThickness(self, event):
thickness = self.thicknessIdMap[event.GetId()]
if thickness != self.sketch.thickness:
self.thicknessButtons[self.sketch.thickness].SetToggle(False)
self.sketch.SetThickness(thickness)
#1:createColorGrid()
方法建造包含颜色按钮的grid
sizer
。首先,我们创建sizer
本身,指定列为4列。由于列数已被设定,所以按钮将被从左到右的布局,然后向下。接下来我们要求颜色的列表,并为每种颜色创建一个按钮。在for
循环中,我们为每种颜色创建了一个方形的位图,并使用wxPython
库中所定义的一般的按钮窗口部件类创建了带有位图的切换按钮。然后我们把按钮与事件相绑定,并把它添加到grid
。之后,我们把它添加到字典以便在以后的代码中,易于关联颜色、ID
和按钮。我们不必指定按钮在网格中的位置;sizer
将为我们做这件事。
#2:createThicknessGrid()
方法基本上类似于createColorGrid()
方法。实际上,一个有进取心的程序员可以把它们做成一个通用函数。grid
sizer
被创建,十六个按钮被一次性添加,sizer
确保了它们在屏幕上很好地排列。
#3:我们使用一个坚直的box
sizer
来放置网格(grid)
。每个grid
的第二个参数都是0,这表明grid
sizer
当control
panel
在垂直方向伸展时不改变尺寸。(由于我们已经知道control
panel
不在水平方向改变尺寸,所以我们不必指定水平方向的行为。)Add()
的第四个参数是项目的边框宽度,这里使用self.SPACING
变量指定。第三个参数wx.ALL
是一套标志中的一个,它控制那些边套用第四个参数指定的边框宽度,wx.ALL
表明对象的四个边都套用。最后,我们调用box
sizer
的Fit()
方法,使用的参数是control
panel
。这个方法告诉control
panel
调整自身尺寸以匹配sizer
认为所需要的最小化尺寸。通常这个方法在使用了sizer
的窗口的构造中被调用,以确保窗口的大小足以包含sizer
。
基类wx.Sizer
包含了几个通用于所有sizer
的方法。表6.9列出了最常用的方法。
表6.9 wx.Sizer
的方法
Add(window, proportion=0,
flag=0, border=0,
userData=None)
Add(sizer, proportion=0,
flag=0, border=0,
userData=None)
Add(size
, proportion
=0,flag
=0, border
=0,userData
=None)
:第一个添加一个wxWindow
,第二个添加一个嵌套的sizer
,第三个添加空的空间,用作分隔符。参数proportion
管理窗口总尺寸,它是相对于别的窗口的改变而言的,它只对wx.BoxSizer
有意义。参数flag
是一个位图,针对对齐、边框位置,增长有许多不同的标志,完整的列表见第十一章。参数border
是窗口或sizer
周围以像素为单位的空间总量。userData
使你能够将对象与数据关联,例如,在一个子类中,可能需要更多的用于尺寸的信息。
Fit(window)
FitInside(window
):调整window
尺寸以匹配sizer
认为所需要的最小化尺寸。这个参数的值通常是使用sizer
的窗口。FitInside()
是一个类似的方法,只不过将改变窗口在屏幕上的显示替换为只改变它的内部实现。它用于scroll
panel
中的窗口以触发滚动栏的显示。
GetSize()
:以wx.Size
对象的形式返回sizer
的尺寸。
GetPosition()
:以wx.Point
对象的形式返回sizer
的位置。
GetMinSize()
:以wx.Size
对象的形式返回完全填充sizer
所需的最小尺寸。
Layout()
:强迫sizer
去重新计算它的孩子的尺寸和位置。在动态地添加或删除了一个孩子之后调用。
Prepend(...)
:与Add()
相同(只是为了布局的目的,把新的对象放在sizer
列表的开头)。
Remove(window)
Remove(sizer)
Remove(nth)
:从sizer
中删除一个对象。
SetDimension(x
, y, width
,height)
:强迫sizer
按照给定的参数重新定位它的所有孩子。
有关sizer
和嵌套sizer
的更详细的信息请参考第11章。
如何建造一个关于(about)框?
about
框是显示对话框的一个好的例子,它能够显示比纯信息框更复杂的信息。这里,你可以使用wx.html.HtmlWindow
作为一个简单的机制来显示样式文本。实际上,wx.html.HtmlWindow
远比我们这里演示的强大,它包括了管理用户交互以及绘制的方法。第16章涵盖了wx.html.HtmlWindow
的特性。例6.10展示了一个类,它使用HTML
renderer
创建一个about
框。
例6.10 使用wx.html.HtmlWindow
作为一个about
框
class SketchAbout(wx.Dialog):
text = '''
<html>
<body bgcolor="#ACAA60">
<center><table bgcolor="#455481" width="100%" cellspacing="0"
cellpadding="0" border="1">
<tr>
<td align="center"><h1>Sketch!</h1></td>
</tr>
</table>
</center>
<p><b>Sketch</b> is a demonstration program for
<b>wxPython In Action</b>
Chapter 6\. It is based on the SuperDoodle demo included
with wxPython, available at http://www.wxpython.org/
</p>
<p><b>SuperDoodle</b> and <b>wxPython</b> are brought to you by
<b>Robin Dunn</b> and <b>Total Control Software</b>, Copyright
© 1997-2006.</p>
</body>
</html>s
'''
def __init__(self, parent):
wx.Dialog.__init__(self, parent, -1, 'About Sketch',
size=(440, 400) )
html = wx.html.HtmlWindow(self)
html.SetPage(self.text)
button = wx.Button(self, wx.ID_OK, "Okay")
sizer = wx.BoxSizer(wx.VERTICAL)
sizer.Add(html, 1, wx.EXPAND|wx.ALL, 5)
sizer.Add(button, 0, wx.ALIGN_CENTER|wx.ALL, 5)
self.SetSizer(sizer)
self.Layout()
上面的HTML
字符串中,有一些布局和字体标记。这里的对话框合并了wx.html.HtmlWindow
和一个wx.ID_OK
ID
按钮。敲击按钮则自动关闭窗口,如同其它对话框一样。一个垂直的box
sizer
用于管理这个布局。
图6.8显示了该对话框。 图6.8
把它作为一个菜单项(About)
的处理器的方法如下:
def OnAbout(self, event):
dlg = SketchAbout(self)
dlg.ShowModal()
dlg.Destroy()
如何建造一个启动画面?
显示一个好的启动画面,将给你的用户一种专业化的感觉。在你的应用程序完成一个费时的设置的时候,它也可以转移用户的注意力。在wxPython
中,使用类wx.SplashScreen
建造一个启动画面是很容易的。启动画面可以保持显示指定的时间,并且无论时间是否被设置,当用户在其上敲击时,它总是会关闭。
wx.SplashScreen
类的构造函数如下:
wx.SplashScreen(bitmap, splashStyle, milliseconds, parent, id,
pos=wx.DefaultPosition, size=wx.DefaultSize,
style=wx.SIMPLE_BORDER|wx.FRAME_NO_TASKBAR|wx.STAY_ON_TOP)
表6.10说明了wx.SplashScreen
构造函数的参数
表6.10 wx.SplashScreen
构造函数的参数
bitmap
:一个wx.Bitmap
,它被显示在屏幕上。
splashStyle
:另一个位图样式,可以是下列的结合:wx.SPLASH_CENTRE_ON_PARENT
,wx.SPLASH_CENTRE_ON_SCREEN
, wx.SPLASH_NO_CENTRE
, wx.SPLASH_TIMEOUT
, wx.SPLASH_NO_TIMEOUT
milliseconds
:如果splashStyle
指定为wx.SPLASH_TIMEOUT
,milliseconds
是保持显示的毫秒数。
parent
:父窗口,通常为None
。
id
:窗口ID
,通常使用-1比较好。
pos
:如果splashStyle
取值wx.SPLASH_NO_CENTER
的话,pos
指定画面在屏幕上的位置。
size
:尺寸。通常你不需要指定这个参数,因为通常使用位图的尺寸。
style
:常规的wxPython
框架的样式,一般使用默认值就可以了。
例6.11显示了启动画面的代码。这里我们用一具自定义的wx.App
子类来替代了wx.PySimpleApp
。
例6.11 一个启动画面的代码
class SketchApp(wx.App):
def OnInit(self):
bmp = wx.Image("splash.png").ConvertToBitmap()
wx.SplashScreen(bmp, wx.SPLASH_CENTRE_ON_SCREEN | wx.SPLASH_TIMEOUT,
1000, None, -1)
wx.Yield()
frame = SketchFrame(None)
frame.Show(True)
self.SetTopWindow(frame)
return True
通常,启动画面被声明在应用程序启动期间的OnInit
方法中。启动画面将一直显示直到它被敲击或超时。这里,启动画面显示在屏幕的中央,一秒后超时。Yield()
的调用很重要,因为它使得在应用程序继续启动前,任何未被处理的事件仍可以被继续处理。这里,Yield()
的调用确保了在应用程序继续启动前,启动画面能够接受并处理它的初始化绘制事件。
本章小结
大多数的应用程序使用了诸如菜单、工具栏和启动画面这样的通常的元素。它们的使用不但对你程序的可用性有帮助,并且使你的应用程序看起来更专业。在这一章里,我们使用了一个简单的
sketch
应用程序,并且使用了工具栏、状态栏、菜单栏,通用对话框、复杂的布局、about
框和启动画面来逐步对它作了改进。你可以使用一个设备上下文来直接对
wxPython
的显示进行绘制。不同的显示要求不同的设备上下文,然而它们共享一个通用API
。为了平滑的显示,设备上下文可以被缓存。一个状态栏能够被自动地创建在框架的底部。它可以包含一个或多个文本域,各文本域可被独立调整尺寸和设置。
- 菜单可以包含嵌套的子菜单,菜单项可以有切换状态。工具栏产生与菜单栏同种的事件,并且被设计来更易于对工具按钮分组布局。
可以使用标准
wx.FileDialog
来管理打开和保存数据。可以使用wx.ColourDialog
来选择颜色。使用
sizer
可以进行窗口部件的复杂布局,而不用明确地指定具体位置。sizer
根据规则自动放置它的孩子对象。sizer
包括的wx.GridSizer
按二维网格来布局对象。wx.BoxSizer
在一条线上布局项目。sizer
可以嵌套,并且当sizer
伸展时可以,它可以控制其孩子的行为。about
框或别的简单的对话框可以使用wx.html.HtmlWindow
来创建。启动画面用wx.SplashScreen
来创建。
在第一部分(part
1)中,我们已经涵盖了wxPython
的基本概念,并且我们已经涉及了一些最常见的任务。在接下来的第二部分(part
2)中,我们将使用目前常见的问答的格式,但是我们将涉及有关wxPython
工具包的组成和功能方面的更详细的问题。