XRC初步
XRC初步(上)
wxPython 中定义用户界面布局可以采用两种方法。传统的方法是将界面布局代码直接写在源文件之中,这种方法不需要学习XML语法,概念上较为简单,避免了同时维护多个文件的麻烦;同时,对IDE的自动完成的支持较好。另一种方法则是采用XML资源文件,即XRC(XML Resource)。XRC的基本出发点是界面布局和程序逻辑的分离,即将界面布局代码采用XML的方式放在分离的文件之中;在程序中不涉及控件的创建和布局,只需要加载相应的资源并处理事件绑定即可。在wxPython中采用XRC分离界面布局和程序逻辑主要有以下几个方面的好处:
1. 提高了程序的可维护性
2. 界面布局可由专业人员设计
3. 更好的支持GUI布局设计工具
4. 作为wxWidgets的规范,XRC资源可通用于C++、Python等语言
示例
使用XRC建立用户界面必须建立两个分离的文件:XML资源文件(.xrc)和python源文件。XRC文件包含了用户界面布局信息,如下例:
#design layout in a separate XML file
< resource >
< object class ="wxFrame" name ="mainFrame" >
< title > My Frame </ title >
< object class ="wxPanel" name ="panel" >
< object class ="wxFlexGridSizer" >
< cols > 2 </ cols >
< rows > 3 </ rows >
< vgap > 5 </ vgap >
< hgap > 5 </ hgap >
< object class ="sizeritem" >
< object class ="wxStaticText" name ="label1" >
< label > First name: </ label >
</ object >
</ object >
< object class ="sizeritem" >
< object class ="wxTextCtrl" name ="text1" />
</ object >
< object class ="sizeritem" >
< object class ="wxStaticText" name ="label2" >
< label > Last name: </ label >
</ object >
</ object >
< object class ="sizeritem" >
< object class ="wxTextCtrl" name ="text2" />
</ object >
< object class ="spacer" >
< size > 0,0 </ size >
</ object >
< object class ="sizeritem" >
< object class ="wxButton" name ="button" >
< label > Submit </ label >
</ object >
</ object >
</ object >
</ object >
</ object >
</ resource >
Python源文件中则包括加载资源文件和事件绑定代码,同时可以使用xrc.XRCCTRL方法从名字获取控件,使用xrc.XRCID方法获取控件ID:
import wx
from wx import xrc
class MyApp(wx.App):
def OnInit(self):
self.res = xrc.XmlResource( ' gui.xrc ' )
assert self.res
self.init_frame()
return True
def init_frame(self):
self.frame = self.res.LoadFrame(None, ' mainFrame ' )
assert self.frame
self.panel = xrc.XRCCTRL(self.frame, ' panel ' )
self.text1 = xrc.XRCCTRL(self.panel, ' text1 ' )
self.text2 = xrc.XRCCTRL(self.panel, ' text2 ' )
self.frame.Bind(wx.EVT_BUTTON, self.OnSubmit, id = xrc.XRCID( ' button ' ))
self.frame.Show()
def OnSubmit(self, evt):
wx.MessageBox( ' Your name is %s %s! ' %
(self.text1.GetValue(), self.text2.GetValue()), ' Feedback ' )
if __name__ == ' __main__ ' :
app = MyApp(False)
app.MainLoop()
创建XRC文件
首先我们看看XRC的组成。XRC文件由一系列预定义的标签组成,你可以注意到这些预定义的标签与控件创建时的关键字参数相似。例如,在wxPython中创建按键的代码如下:
与之相应的XRC代码则是这个样子:
< label > Submit </ label >
</ object >
从例示中可以注意到几个XRC的关键概念:
1. 每个控件与一个XML节点相对应
2. 控件间的层次关系与XML节点间层次关系相对应,放置控件的容器与相应的XML节点的父节点相对应
3. 节点class属性值对应控件的C++类名
4. 节点name属性值为控件在XRC文件中的唯一标识,可通过该值自python源文件中获取控件
5. label等其余参数在XRC文件中作为节点的子节点出现
有了这些基本概念,现在我们可以使用XRC文件来布局我们的用户界面了。存在大量的工具以可视化的方式来帮助我们完成这个繁琐的工作。wxPython 自带的XRCED以一种半可视化的方式(可视化的设定控件属性并预览,但不支持直接拖放控件)支持用户界面设计;开源的wxglade则支持直接的控件拖放,并可生成C++、python、perl、lisp和XRC的源文件;wxDesigner、dialogBlock,wxDesigner,BOA 等工具同样值得一试。
XRC初步(下)
python源文件中的处理
完成了XRC界面布局文件的编写,下一步必须在python源文件中做相应的处理。与XRC处理相关的wxPython代码段主要包括三个方面:资源文件的加载,控件的获取和事件绑定代码:
1.导入与XRC处理相关的xrc模块:
2.加载资源文件:
3.获取控件。此过程不需要显式的创建控件,通过设计XRC文件时相应的name属性值获取即可:
# 第二个参数为设计XRC文件时Frame的name属性值
self.frame = self.res.LoadFrame(None, ' mainFrame ' )
# 获取控件,第一个参数为控件的父窗口
# 第二个参数为设计XRC文件时控件的name属性值
self.panel = xrc.XRCCTRL(self.frame, ' panel ' )
self.text1 = xrc.XRCCTRL(self.panel, ' text1 ' )
# 获取panel中的控件时不必显式获取panel本身,直接传入self.frame即可递归向下查找
self.text2 = xrc.XRCCTRL(self.frame, ' text2 ' )
# 获取控件ID,参数为设计XRC文件时控件的name属性值
self.id = xrc.XRCID( ' button ' )
4.绑定事件处理有两种方式:
a. 绑定按键事件:
self.frame.Bind(wx.EVT_BUTTON, self.OnSubmit, self.button)
b. 因为xrc.XRCCTRL仅能返回wx.Window的派生类,而wxMenuItem不是派生自wx.Window,不能采用xrc.XRCCTRL 获取菜单项,因此事件必须委托给Frame绑定。派生自wx.Window的按键等控件也可以采用本方法绑定:
动态创建
加载Frame窗体时将自动加载其子控件和子窗体,那么,你如何控制子窗体和子控件的加载呢?为此,你必须将子窗体定义为和窗体节体平行的顶级节点 (Frames、Dialogs、Panels、Toolbars、Menus和MenuBars可以作为顶级节点),并通过程序控制加载。如下例:
dynamic.xrc文件:
< resource >
< object class ="wxFrame" name ="mainFrame" >
< title > Primary Frame </ title >
< object class ="wxPanel" name ="mainPanel" >
< object class ="wxButton" name ="button" >
< label > New Frame </ label >
</ object >
</ object >
</ object >
< object class ="wxFrame" name ="nextFrame" >
< title > Secondary Frame </ title >
< object class ="wxPanel" name ="nextPanel" >
< object class ="wxStaticText" name ="label" >
< label > This is a dynamically created frame. </ label >
</ object >
</ object >
</ object >
</ resource >
Python源文件:
from wx import xrc
class MyApp(wx.App):
def OnInit(self):
self.res = xrc.XmlResource( ' dynamic.xrc ' )
self.init_frame()
return True
def init_frame(self):
self.frame = self.res.LoadFrame(None, ' mainFrame ' )
self.panel = xrc.XRCCTRL(self.frame, ' mainPanel ' )
self.button = xrc.XRCCTRL(self.panel, ' button ' )
self.frame.Bind(wx.EVT_BUTTON, self.OnNewFrame, self.button)
self.frame.Show()
def OnNewFrame(self, evt):
self.frame2 = self.res.LoadFrame(None, ' nextFrame ' )
self.frame2.Show()
if __name__ == ' __main__ ' :
app = MyApp(False)
app.MainLoop()
动态添加子控件时必须首先调用父窗口的GetSizer方法,创建控件后添加到Sizer,并调用Sizer的Fit方法为控件留出显示空间:
my_sizer = MainWindow.GetSizer()
my_text = wx.TextCtrl(MainWindow, - 1 , " Test " , size = ( 325 , 200 ))
my_sizer.Add(my_text, 1 , wx.EXPAND | wx.ADJUST_MINSIZE, 0)
my_sizer.Fit(MainWindow)