]> git.saurik.com Git - wxWidgets.git/blobdiff - wxPython/demo/XmlResourceHandler.py
Renamed demo modules to be wx-less.
[wxWidgets.git] / wxPython / demo / XmlResourceHandler.py
diff --git a/wxPython/demo/XmlResourceHandler.py b/wxPython/demo/XmlResourceHandler.py
new file mode 100644 (file)
index 0000000..2098c5d
--- /dev/null
@@ -0,0 +1,195 @@
+# 11/22/2003 - Jeff Grimmett (grimmtooth@softhome.net)
+#
+# o Updated for wx namespace
+# o There are issues using the wx namespace within the xrc code.
+#
+# 11/30/2003 - Jeff Grimmett (grimmtooth@softhome.net)
+#
+# o Error report: "Error: No handler found for XML node 'object', 
+#   class 'wx.StaticText'!"; no text shows on panel.
+#
+
+import  wx
+import  wx.xrc  as  xrc
+
+#----------------------------------------------------------------------
+
+resourceText = r'''<?xml version="1.0"?>
+<resource>
+
+<!-- Notice that the class is NOT a standard wx class -->
+
+<object class="MyBluePanel" name="MyPanel">
+    <size>200,100</size>
+    <object class="wx.StaticText" name="label1">
+        <label>This blue panel is a class derived from wx.Panel,\nand is loaded by a custom XmlResourceHandler.</label>
+        <pos>10,10</pos>
+    </object>
+</object>
+</resource>
+'''
+
+#----------------------------------------------------------------------
+
+class MyBluePanel(wx.Panel):
+    def __init__(self, parent, id, pos, size, style, name):
+        wx.Panel.__init__(self, parent, id, pos, size, style, name)
+
+        # This is the little bit of customization that we do for this
+        # silly example.  It could just as easily have been done in
+        # the resource.
+        self.SetBackgroundColour("BLUE")
+        self.SetForegroundColour("WHITE")
+
+
+# To do it the more complex way, (see below) we need to write the
+# class a little differently...  This could obviously be done with a
+# single class, but I wanted to make separate ones to make clear what
+# the different requirements are.
+class PreMyBluePanel(wx.Panel):
+    def __init__(self):
+        p = wx.PrePanel()
+        self.PostCreate(p)
+
+    def Create(self, parent, id, pos, size, style, name):
+        wx.Panel.Create(self, parent, id, pos, size, style, name)
+        self.SetBackgroundColour("BLUE")
+        self.SetForegroundColour("WHITE")
+
+
+#----------------------------------------------------------------------
+
+class MyBluePanelXmlHandler(xrc.XmlResourceHandler):
+    def __init__(self):
+        xrc.XmlResourceHandler.__init__(self)
+        # Specify the styles recognized by objects of this type
+        self.AddStyle("wx.NO_3D", wx.NO_3D);
+        self.AddStyle("wx.TAB_TRAVERSAL", wx.TAB_TRAVERSAL);
+        self.AddStyle("wx.WS_EX_VALIDATE_RECURSIVELY", wx.WS_EX_VALIDATE_RECURSIVELY);
+        self.AddStyle("wx.CLIP_CHILDREN", wx.CLIP_CHILDREN);
+        self.AddWindowStyles();
+
+    # This method and the next one are required for XmlResourceHandlers
+    def CanHandle(self, node):
+        return self.IsOfClass(node, "MyBluePanel")
+
+    def DoCreateResource(self):
+        # NOTE: wxWindows can be created in either a single-phase or
+        # in a two-phase way.  Single phase is what you normally do,
+        # and two-phase creates the instnace first, and then later
+        # creates the actual window when the Create method is called.
+        # (In wxPython the first phase is done using the wxPre*
+        # function, for example, wxPreFrame, wxPrePanel, etc.)
+        #
+        # wxXmlResource supports either method, a premade instance can
+        # be created and populated by xrc using the appropriate
+        # LoadOn* method (such as LoadOnPanel) or xrc can create the
+        # instance too, using the Load* method.  However this makes
+        # the handlers a bit more complex.  If you can be sure that a
+        # particular class will never be loaded using a pre-existing
+        # instance, then you can make the handle much simpler.  I'll
+        # show both methods below.
+
+        if 1:
+            # The simple method assumes that there is no existing
+            # instance.  Be sure of that with an assert.
+            assert self.GetInstance() is None
+
+            # Now create the object
+            panel = MyBluePanel(self.GetParentAsWindow(),
+                                self.GetID(),
+                                self.GetPosition(),
+                                self.GetSize(),
+                                self.GetStyle("style", wx.TAB_TRAVERSAL),
+                                self.GetName()
+                                )
+        else:
+            # When using the more complex (but more flexible) method
+            # the instance may already have been created, check for it
+            panel = self.GetInstance()
+            if panel is None:
+                # if not, then create the instance (but not the window)
+                panel = PreMyBluePanel()
+
+            # Now call the panel's Create method to actually create the window
+            panel.Create(self.GetParentAsWindow(),
+                         self.GetID(),
+                         self.GetPosition(),
+                         self.GetSize(),
+                         self.GetStyle("style", wx.TAB_TRAVERSAL),
+                         self.GetName()
+                         )
+
+        # These two things should be done in either case:
+        # Set standard window attributes
+        self.SetupWindow(panel)
+        # Create any child windows of this node
+        self.CreateChildren(panel)
+
+        return panel
+
+
+#----------------------------------------------------------------------
+
+
+class TestPanel(wx.Panel):
+    def __init__(self, parent, log):
+        self.log = log
+        wx.Panel.__init__(self, parent, -1)
+
+        # make the components
+        label = wx.StaticText(self, -1, "The lower panel was built from this XML:")
+        label.SetFont(wx.Font(12, wx.SWISS, wx.NORMAL, wx.BOLD))
+
+        text = wx.TextCtrl(self, -1, resourceText,
+                          style=wx.TE_READONLY|wx.TE_MULTILINE)
+        text.SetInsertionPoint(0)
+
+        line = wx.StaticLine(self, -1)
+
+        # Load the resource
+        res = xrc.EmptyXmlResource()
+        res.InsertHandler(MyBluePanelXmlHandler())
+        res.LoadFromString(resourceText)
+
+        # Now create a panel from the resource data
+        panel = res.LoadObject(self, "MyPanel", "MyBluePanel")
+
+        # and do the layout
+        sizer = wx.BoxSizer(wx.VERTICAL)
+        sizer.Add(label, 0, wx.EXPAND|wx.TOP|wx.LEFT, 5)
+        sizer.Add(text, 1, wx.EXPAND|wx.ALL, 5)
+        sizer.Add(line, 0, wx.EXPAND)
+        sizer.Add(panel, 1, wx.EXPAND|wx.ALL, 5)
+
+        self.SetSizer(sizer)
+        self.SetAutoLayout(True)
+
+
+#----------------------------------------------------------------------
+
+def runTest(frame, nb, log):
+    win = TestPanel(nb, log)
+    return win
+
+#----------------------------------------------------------------------
+
+
+
+overview = """<html><body>
+<h2><center>wxXmlResourceHandler</center></h2>
+
+Deriving a class from wxXmlResourceHandler allows you to specify your
+own classes in XRC resources, and your handler class will then be used
+to create instances of that class when the resource is loaded.
+
+</body></html>
+"""
+
+
+
+if __name__ == '__main__':
+    import sys,os
+    import run
+    run.main(['', os.path.basename(sys.argv[0])])
+