XRC初步

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

<? xmlversion="1.0"encoding="utf-8" ?>
< resource >
< object class ="wxFrame" name ="mainFrame" >
< title > MyFrame </ 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 > Firstname: </ label >
</ object >
</ object >
< object class ="sizeritem" >
< object class ="wxTextCtrl" name ="text1" />
</ object >
< object class ="sizeritem" >
< object class ="wxStaticText" name ="label2" >
< label > Lastname: </ 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：

# logicbyitselfinmodule

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( ' Yournameis%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文件：

<? xmlversion="1.0"encoding="utf-8" ?>
< resource >
< object class ="wxFrame" name ="mainFrame" >
< title > PrimaryFrame </ title >
< object class ="wxPanel" name ="mainPanel" >
< object class ="wxButton" name ="button" >
< label > NewFrame </ label >
</ object >
</ object >
</ object >
< object class ="wxFrame" name ="nextFrame" >
< title > SecondaryFrame </ title >
< object class ="wxPanel" name ="nextPanel" >
< object class ="wxStaticText" name ="label" >
< label > Thisisadynamicallycreatedframe. </ 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)