XRC初步
转自:
云雀 的
XRC初步(上) 和
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
<?xml version="1.0" encoding="utf-8" ?>
<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:
#logic by itself in module
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中创建按键的代码如下:
button = wx.Button(parent = panel, id = wx.ID_ANY, label = 'Submit')
与之相应的XRC代码则是这个样子:
<object class="wxButton" name="button">
<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模块:
import wx.xrc as xrc
2.加载资源文件:
self.res = xrc.XmlResource('XRCfilename.xrc')
3.获取控件。此过程不需要显式的创建控件,通过设计XRC文件时相应的name属性值获取即可:
# 加载Frame,第一个参数为父窗口,当前为顶层窗口,故为None
# 第二个参数为设计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.button = xrc.XRCCTRL(self.panel, 'button')
self.frame.Bind(wx.EVT_BUTTON, self.OnSubmit, self.button)
b. 因为xrc.XRCCTRL仅能返回wx.Window的派生类,而wxMenuItem不是派生自wx.Window,不能采用xrc.XRCCTRL 获取菜单项,因此事件必须委托给Frame绑定。派生自wx.Window的按键等控件也可以采用本方法绑定:
self.frame.Bind(wx.EVT_BUTTON, self.OnSubmit, id=xrc.XRCID('button'))
动态创建
加载Frame窗体时将自动加载其子控件和子窗体,那么,你如何控制子窗体和子控件的加载呢?为此,你必须将子窗体定义为和窗体节体平行的顶级节点 (Frames、Dialogs、Panels、Toolbars、Menus和MenuBars可以作为顶级节点),并通过程序控制加载。如下例:
dynamic.xrc文件:
<?xml version="1.0" encoding="utf-8" ?>
<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源文件:
import wx
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方法为控件留出显示空间:
MainWindow = res.LoadFrame(None, "frame_1")
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)