1 /////////////////////////////////////////////////////////////////////////////
2 // Name: wx/xrc/xmlres.h
3 // Purpose: XML resources
4 // Author: Vaclav Slavik
7 // Copyright: (c) 2000 Vaclav Slavik
8 // Licence: wxWindows licence
9 /////////////////////////////////////////////////////////////////////////////
18 #include "wx/string.h"
19 #include "wx/dynarray.h"
20 #include "wx/arrstr.h"
21 #include "wx/datetime.h"
23 #include "wx/gdicmn.h"
24 #include "wx/filesys.h"
25 #include "wx/bitmap.h"
27 #include "wx/artprov.h"
28 #include "wx/colour.h"
29 #include "wx/animate.h"
30 #include "wx/vector.h"
32 #include "wx/xml/xml.h"
34 class WXDLLIMPEXP_FWD_BASE wxFileName
;
36 class WXDLLIMPEXP_FWD_CORE wxIconBundle
;
37 class WXDLLIMPEXP_FWD_CORE wxImageList
;
38 class WXDLLIMPEXP_FWD_CORE wxMenu
;
39 class WXDLLIMPEXP_FWD_CORE wxMenuBar
;
40 class WXDLLIMPEXP_FWD_CORE wxDialog
;
41 class WXDLLIMPEXP_FWD_CORE wxPanel
;
42 class WXDLLIMPEXP_FWD_CORE wxWindow
;
43 class WXDLLIMPEXP_FWD_CORE wxFrame
;
44 class WXDLLIMPEXP_FWD_CORE wxToolBar
;
46 class WXDLLIMPEXP_FWD_XRC wxXmlResourceHandler
;
47 class WXDLLIMPEXP_FWD_XRC wxXmlSubclassFactory
;
48 class wxXmlSubclassFactories
;
49 class wxXmlResourceModule
;
50 class wxXmlResourceDataRecords
;
52 // These macros indicate current version of XML resources (this information is
53 // encoded in root node of XRC file as "version" property).
55 // Rules for increasing version number:
56 // - change it only if you made incompatible change to the format. Addition
57 // of new attribute to control handler is _not_ incompatible change, because
58 // older versions of the library may ignore it.
59 // - if you change version number, follow these steps:
60 // - set major, minor and release numbers to respective version numbers of
61 // the wxWidgets library (see wx/version.h)
62 // - reset revision to 0 unless the first three are same as before,
63 // in which case you should increase revision by one
64 #define WX_XMLRES_CURRENT_VERSION_MAJOR 2
65 #define WX_XMLRES_CURRENT_VERSION_MINOR 5
66 #define WX_XMLRES_CURRENT_VERSION_RELEASE 3
67 #define WX_XMLRES_CURRENT_VERSION_REVISION 0
68 #define WX_XMLRES_CURRENT_VERSION_STRING wxT("2.5.3.0")
70 #define WX_XMLRES_CURRENT_VERSION \
71 (WX_XMLRES_CURRENT_VERSION_MAJOR * 256*256*256 + \
72 WX_XMLRES_CURRENT_VERSION_MINOR * 256*256 + \
73 WX_XMLRES_CURRENT_VERSION_RELEASE * 256 + \
74 WX_XMLRES_CURRENT_VERSION_REVISION)
76 enum wxXmlResourceFlags
79 wxXRC_NO_SUBCLASSING
= 2,
80 wxXRC_NO_RELOADING
= 4
83 // This class holds XML resources from one or more .xml files
84 // (or derived forms, either binary or zipped -- see manual for
86 class WXDLLIMPEXP_XRC wxXmlResource
: public wxObject
90 // Flags: wxXRC_USE_LOCALE
91 // translatable strings will be translated via _()
92 // using the given domain if specified
93 // wxXRC_NO_SUBCLASSING
94 // subclass property of object nodes will be ignored
95 // (useful for previews in XRC editors)
97 // don't check the modification time of the XRC files and
98 // reload them if they have changed on disk
99 wxXmlResource(int flags
= wxXRC_USE_LOCALE
,
100 const wxString
& domain
= wxEmptyString
);
103 // Flags: wxXRC_USE_LOCALE
104 // translatable strings will be translated via _()
105 // using the given domain if specified
106 // wxXRC_NO_SUBCLASSING
107 // subclass property of object nodes will be ignored
108 // (useful for previews in XRC editors)
109 wxXmlResource(const wxString
& filemask
, int flags
= wxXRC_USE_LOCALE
,
110 const wxString
& domain
= wxEmptyString
);
113 virtual ~wxXmlResource();
115 // Loads resources from XML files that match given filemask.
116 // This method understands wxFileSystem URLs if wxUSE_FILESYS.
117 bool Load(const wxString
& filemask
);
119 // Loads resources from single XRC file.
120 bool LoadFile(const wxFileName
& file
);
122 // Loads all XRC files from a directory.
123 bool LoadAllFiles(const wxString
& dirname
);
125 // Unload resource from the given XML file (wildcards not allowed)
126 bool Unload(const wxString
& filename
);
128 // Initialize handlers for all supported controls/windows. This will
129 // make the executable quite big because it forces linking against
130 // most of the wxWidgets library.
131 void InitAllHandlers();
133 // Initialize only a specific handler (or custom handler). Convention says
134 // that handler name is equal to the control's name plus 'XmlHandler', for
135 // example wxTextCtrlXmlHandler, wxHtmlWindowXmlHandler. The XML resource
136 // compiler (xmlres) can create include file that contains initialization
137 // code for all controls used within the resource.
138 void AddHandler(wxXmlResourceHandler
*handler
);
140 // Add a new handler at the beginning of the handler list
141 void InsertHandler(wxXmlResourceHandler
*handler
);
143 // Removes all handlers
144 void ClearHandlers();
146 // Registers subclasses factory for use in XRC. This function is not meant
147 // for public use, please see the comment above wxXmlSubclassFactory
149 static void AddSubclassFactory(wxXmlSubclassFactory
*factory
);
151 // Loads menu from resource. Returns NULL on failure.
152 wxMenu
*LoadMenu(const wxString
& name
);
154 // Loads menubar from resource. Returns NULL on failure.
155 wxMenuBar
*LoadMenuBar(wxWindow
*parent
, const wxString
& name
);
157 // Loads menubar from resource. Returns NULL on failure.
158 wxMenuBar
*LoadMenuBar(const wxString
& name
) { return LoadMenuBar(NULL
, name
); }
162 wxToolBar
*LoadToolBar(wxWindow
*parent
, const wxString
& name
);
165 // Loads a dialog. dlg points to parent window (if any).
166 wxDialog
*LoadDialog(wxWindow
*parent
, const wxString
& name
);
168 // Loads a dialog. dlg points to parent window (if any). This form
169 // is used to finish creation of already existing instance (main reason
170 // for this is that you may want to use derived class with new event table)
171 // Example (typical usage):
173 // wxTheXmlResource->LoadDialog(&dlg, mainFrame, "my_dialog");
175 bool LoadDialog(wxDialog
*dlg
, wxWindow
*parent
, const wxString
& name
);
177 // Loads a panel. panel points to parent window (if any).
178 wxPanel
*LoadPanel(wxWindow
*parent
, const wxString
& name
);
180 // Loads a panel. panel points to parent window (if any). This form
181 // is used to finish creation of already existing instance.
182 bool LoadPanel(wxPanel
*panel
, wxWindow
*parent
, const wxString
& name
);
185 wxFrame
*LoadFrame(wxWindow
* parent
, const wxString
& name
);
186 bool LoadFrame(wxFrame
* frame
, wxWindow
*parent
, const wxString
& name
);
188 // Load an object from the resource specifying both the resource name and
189 // the classname. This lets you load nonstandard container windows.
190 wxObject
*LoadObject(wxWindow
*parent
, const wxString
& name
,
191 const wxString
& classname
)
193 return DoLoadObject(parent
, name
, classname
, false /* !recursive */);
196 // Load an object from the resource specifying both the resource name and
197 // the classname. This form lets you finish the creation of an existing
199 bool LoadObject(wxObject
*instance
,
201 const wxString
& name
,
202 const wxString
& classname
)
204 return DoLoadObject(instance
, parent
, name
, classname
, false);
207 // These versions of LoadObject() look for the object with the given name
208 // recursively (breadth first) and can be used to instantiate an individual
209 // control defined anywhere in an XRC file. No check is done that the name
210 // is unique, it's up to the caller to ensure this.
211 wxObject
*LoadObjectRecursively(wxWindow
*parent
,
212 const wxString
& name
,
213 const wxString
& classname
)
215 return DoLoadObject(parent
, name
, classname
, true /* recursive */);
218 bool LoadObjectRecursively(wxObject
*instance
,
220 const wxString
& name
,
221 const wxString
& classname
)
223 return DoLoadObject(instance
, parent
, name
, classname
, true);
226 // Loads a bitmap resource from a file.
227 wxBitmap
LoadBitmap(const wxString
& name
);
229 // Loads an icon resource from a file.
230 wxIcon
LoadIcon(const wxString
& name
);
232 // Attaches an unknown control to the given panel/window/dialog.
233 // Unknown controls are used in conjunction with <object class="unknown">.
234 bool AttachUnknownControl(const wxString
& name
, wxWindow
*control
,
235 wxWindow
*parent
= NULL
);
237 // Returns a numeric ID that is equivalent to the string ID used in an XML
238 // resource. If an unknown str_id is requested (i.e. other than wxID_XXX
239 // or integer), a new record is created which associates the given string
240 // with a number. If value_if_not_found == wxID_NONE, the number is obtained via
241 // wxWindow::NewControlId(). Otherwise value_if_not_found is used.
242 // Macro XRCID(name) is provided for convenient use in event tables.
243 static int GetXRCID(const wxString
& str_id
, int value_if_not_found
= wxID_NONE
)
244 { return DoGetXRCID(str_id
.mb_str(), value_if_not_found
); }
246 // version for internal use only
247 static int DoGetXRCID(const char *str_id
, int value_if_not_found
= wxID_NONE
);
250 // Find the string ID with the given numeric value, returns an empty string
251 // if no such ID is found.
253 // Notice that unlike GetXRCID(), which is fast, this operation is slow as
254 // it checks all the IDs used in XRC.
255 static wxString
FindXRCIDById(int numId
);
258 // Returns version information (a.b.c.d = d+ 256*c + 256^2*b + 256^3*a).
259 long GetVersion() const { return m_version
; }
261 // Compares resources version to argument. Returns -1 if resources version
262 // is less than the argument, +1 if greater and 0 if they equal.
263 int CompareVersion(int major
, int minor
, int release
, int revision
) const
264 { return GetVersion() -
265 (major
*256*256*256 + minor
*256*256 + release
*256 + revision
); }
267 //// Singleton accessors.
269 // Gets the global resources object or creates one if none exists.
270 static wxXmlResource
*Get();
272 // Sets the global resources object and returns a pointer to the previous one (may be NULL).
273 static wxXmlResource
*Set(wxXmlResource
*res
);
275 // Returns flags, which may be a bitlist of wxXRC_USE_LOCALE and wxXRC_NO_SUBCLASSING.
276 int GetFlags() const { return m_flags
; }
277 // Set flags after construction.
278 void SetFlags(int flags
) { m_flags
= flags
; }
280 // Get/Set the domain to be passed to the translation functions, defaults
281 // to empty string (no domain).
282 const wxString
& GetDomain() const { return m_domain
; }
283 void SetDomain(const wxString
& domain
);
286 // This function returns the wxXmlNode containing the definition of the
287 // object with the given name or NULL.
289 // It can be used to access additional information defined in the XRC file
290 // and not used by wxXmlResource itself.
291 const wxXmlNode
*GetResourceNode(const wxString
& name
) const
292 { return GetResourceNodeAndLocation(name
, wxString(), true); }
295 // reports input error at position 'context'
296 void ReportError(const wxXmlNode
*context
, const wxString
& message
);
298 // override this in derived class to customize errors reporting
299 virtual void DoReportError(const wxString
& xrcFile
, const wxXmlNode
*position
,
300 const wxString
& message
);
302 // Load the contents of a single file and returns its contents as a new
303 // wxXmlDocument (which will be owned by caller) on success or NULL.
304 wxXmlDocument
*DoLoadFile(const wxString
& file
);
306 // Scans the resources list for unloaded files and loads them. Also reloads
307 // files that have been modified since last loading.
308 bool UpdateResources();
311 // Common implementation of GetResourceNode() and FindResource(): searches
312 // all top-level or all (if recursive == true) nodes if all loaded XRC
313 // files and returns the node, if found, as well as the path of the file it
314 // was found in if path is non-NULL
315 wxXmlNode
*GetResourceNodeAndLocation(const wxString
& name
,
316 const wxString
& classname
,
317 bool recursive
= false,
318 wxString
*path
= NULL
) const;
321 // Note that these functions are used outside of wxWidgets itself, e.g.
322 // there are several known cases of inheriting from wxXmlResource just to
323 // be able to call FindResource() so we keep them for compatibility even if
324 // their names are not really consistent with GetResourceNode() public
325 // function and FindResource() is also non-const because it changes the
326 // current path of m_curFileSystem to ensure that relative paths work
327 // correctly when CreateResFromNode() is called immediately afterwards
328 // (something const public function intentionally does not do)
330 // Returns the node containing the resource with the given name and class
331 // name unless it's empty (then any class matches) or NULL if not found.
332 wxXmlNode
*FindResource(const wxString
& name
, const wxString
& classname
,
333 bool recursive
= false);
335 // Helper function used by FindResource() to look under the given node.
336 wxXmlNode
*DoFindResource(wxXmlNode
*parent
, const wxString
& name
,
337 const wxString
& classname
, bool recursive
) const;
339 // Creates a resource from information in the given node
340 // (Uses only 'handlerToUse' if != NULL)
341 wxObject
*CreateResFromNode(wxXmlNode
*node
, wxObject
*parent
,
342 wxObject
*instance
= NULL
,
343 wxXmlResourceHandler
*handlerToUse
= NULL
)
345 return node
? DoCreateResFromNode(*node
, parent
, instance
, handlerToUse
)
349 // Helper of Load() and Unload(): returns the URL corresponding to the
350 // given file if it's indeed a file, otherwise returns the original string
352 static wxString
ConvertFileNameToURL(const wxString
& filename
);
354 // loading resources from archives is impossible without wxFileSystem
356 // Another helper: detect if the filename is a ZIP or XRS file
357 static bool IsArchive(const wxString
& filename
);
358 #endif // wxUSE_FILESYSTEM
361 wxXmlResourceDataRecords
& Data() { return *m_data
; }
362 const wxXmlResourceDataRecords
& Data() const { return *m_data
; }
364 // the real implementation of CreateResFromNode(): this should be only
365 // called if node is non-NULL
366 wxObject
*DoCreateResFromNode(wxXmlNode
& node
,
369 wxXmlResourceHandler
*handlerToUse
= NULL
);
371 // common part of LoadObject() and LoadObjectRecursively()
372 wxObject
*DoLoadObject(wxWindow
*parent
,
373 const wxString
& name
,
374 const wxString
& classname
,
376 bool DoLoadObject(wxObject
*instance
,
378 const wxString
& name
,
379 const wxString
& classname
,
386 wxVector
<wxXmlResourceHandler
*> m_handlers
;
387 wxXmlResourceDataRecords
*m_data
;
389 wxFileSystem m_curFileSystem
;
390 wxFileSystem
& GetCurFileSystem() { return m_curFileSystem
; }
393 // domain to pass to translation functions, if any.
396 friend class wxXmlResourceHandler
;
397 friend class wxXmlResourceModule
;
398 friend class wxIdRangeManager
;
399 friend class wxIdRange
;
401 static wxXmlSubclassFactories
*ms_subclassFactories
;
403 // singleton instance:
404 static wxXmlResource
*ms_instance
;
408 // This macro translates string identifier (as used in XML resource,
409 // e.g. <menuitem id="my_menu">...</menuitem>) to integer id that is needed by
410 // wxWidgets event tables.
412 // BEGIN_EVENT_TABLE(MyFrame, wxFrame)
413 // EVT_MENU(XRCID("quit"), MyFrame::OnQuit)
414 // EVT_MENU(XRCID("about"), MyFrame::OnAbout)
415 // EVT_MENU(XRCID("new"), MyFrame::OnNew)
416 // EVT_MENU(XRCID("open"), MyFrame::OnOpen)
419 #define XRCID(str_id) \
420 wxXmlResource::DoGetXRCID(str_id)
423 // This macro returns pointer to particular control in dialog
424 // created using XML resources. You can use it to set/get values from
428 // wxXmlResource::Get()->LoadDialog(&dlg, mainFrame, "my_dialog");
429 // XRCCTRL(dlg, "my_textctrl", wxTextCtrl)->SetValue(wxT("default value"));
431 #define XRCCTRL(window, id, type) \
432 (wxStaticCast((window).FindWindow(XRCID(id)), type))
434 // This macro returns pointer to sizer item
437 // <object class="spacer" name="area">
438 // <size>400, 300</size>
441 // wxSizerItem* item = XRCSIZERITEM(*this, "area")
443 #define XRCSIZERITEM(window, id) \
444 ((window).GetSizer() ? (window).GetSizer()->GetItemById(XRCID(id)) : NULL)
446 // wxXmlResourceHandler is an abstract base class for resource handlers
447 // capable of creating a control from an XML node.
449 class WXDLLIMPEXP_XRC wxXmlResourceHandler
: public wxObject
451 DECLARE_ABSTRACT_CLASS(wxXmlResourceHandler
)
454 wxXmlResourceHandler();
457 virtual ~wxXmlResourceHandler() {}
459 // Creates an object (menu, dialog, control, ...) from an XML node.
460 // Should check for validity.
461 // parent is a higher-level object (usually window, dialog or panel)
462 // that is often necessary to create the resource.
463 // If instance is non-NULL it should not create a new instance via 'new' but
464 // should rather use this one, and call its Create method.
465 wxObject
*CreateResource(wxXmlNode
*node
, wxObject
*parent
,
468 // This one is called from CreateResource after variables
470 virtual wxObject
*DoCreateResource() = 0;
472 // Returns true if it understands this node and can create
473 // a resource from it, false otherwise.
474 virtual bool CanHandle(wxXmlNode
*node
) = 0;
476 // Sets the parent resource.
477 void SetParentResource(wxXmlResource
*res
) { m_resource
= res
; }
480 wxXmlResource
*m_resource
;
481 wxArrayString m_styleNames
;
482 wxArrayInt m_styleValues
;
484 // Variables (filled by CreateResource)
487 wxObject
*m_parent
, *m_instance
;
488 wxWindow
*m_parentAsWindow
;
490 // --- Handy methods:
492 // Returns true if the node has a property class equal to classname,
493 // e.g. <object class="wxDialog">.
494 static bool IsOfClass(wxXmlNode
*node
, const wxString
& classname
);
496 // Gets node content from wxXML_ENTITY_NODE
497 // The problem is, <tag>content<tag> is represented as
498 // wxXML_ENTITY_NODE name="tag", content=""
499 // |-- wxXML_TEXT_NODE or
500 // wxXML_CDATA_SECTION_NODE name="" content="content"
501 wxString
GetNodeContent(const wxXmlNode
*node
);
503 // Check to see if a parameter exists.
504 bool HasParam(const wxString
& param
);
506 // Finds the node or returns NULL.
507 wxXmlNode
*GetParamNode(const wxString
& param
);
509 // Finds the parameter value or returns the empty string.
510 wxString
GetParamValue(const wxString
& param
);
512 // Returns the parameter value from given node.
513 wxString
GetParamValue(const wxXmlNode
* node
);
515 // Add a style flag (e.g. wxMB_DOCKABLE) to the list of flags
516 // understood by this handler.
517 void AddStyle(const wxString
& name
, int value
);
519 // Add styles common to all wxWindow-derived classes.
520 void AddWindowStyles();
522 // Gets style flags from text in form "flag | flag2| flag3 |..."
523 // Only understands flags added with AddStyle
524 int GetStyle(const wxString
& param
= wxT("style"), int defaults
= 0);
526 // Gets text from param and does some conversions:
527 // - replaces \n, \r, \t by respective chars (according to C syntax)
528 // - replaces _ by & and __ by _ (needed for _File => &File because of XML)
529 // - calls wxGetTranslations (unless disabled in wxXmlResource)
530 wxString
GetText(const wxString
& param
, bool translate
= true);
532 // Returns the XRCID.
535 // Returns the resource name.
538 // Gets a bool flag (1, t, yes, on, true are true, everything else is false).
539 bool GetBool(const wxString
& param
, bool defaultv
= false);
541 // Gets an integer value from the parameter.
542 long GetLong(const wxString
& param
, long defaultv
= 0);
544 // Gets a float value from the parameter.
545 float GetFloat(const wxString
& param
, float defaultv
= 0);
547 // Gets colour in HTML syntax (#RRGGBB).
548 wxColour
GetColour(const wxString
& param
, const wxColour
& defaultv
= wxNullColour
);
550 // Gets the size (may be in dialog units).
551 wxSize
GetSize(const wxString
& param
= wxT("size"),
552 wxWindow
*windowToUse
= NULL
);
554 // Gets the position (may be in dialog units).
555 wxPoint
GetPosition(const wxString
& param
= wxT("pos"));
557 // Gets a dimension (may be in dialog units).
558 wxCoord
GetDimension(const wxString
& param
, wxCoord defaultv
= 0,
559 wxWindow
*windowToUse
= NULL
);
561 // Gets a direction, complains if the value is invalid.
562 wxDirection
GetDirection(const wxString
& param
, wxDirection dir
= wxLEFT
);
565 wxBitmap
GetBitmap(const wxString
& param
= wxT("bitmap"),
566 const wxArtClient
& defaultArtClient
= wxART_OTHER
,
567 wxSize size
= wxDefaultSize
);
569 // Gets a bitmap from an XmlNode.
570 wxBitmap
GetBitmap(const wxXmlNode
* node
,
571 const wxArtClient
& defaultArtClient
= wxART_OTHER
,
572 wxSize size
= wxDefaultSize
);
575 wxIcon
GetIcon(const wxString
& param
= wxT("icon"),
576 const wxArtClient
& defaultArtClient
= wxART_OTHER
,
577 wxSize size
= wxDefaultSize
);
579 // Gets an icon from an XmlNode.
580 wxIcon
GetIcon(const wxXmlNode
* node
,
581 const wxArtClient
& defaultArtClient
= wxART_OTHER
,
582 wxSize size
= wxDefaultSize
);
584 // Gets an icon bundle.
585 wxIconBundle
GetIconBundle(const wxString
& param
,
586 const wxArtClient
& defaultArtClient
= wxART_OTHER
);
588 // Gets an image list.
589 wxImageList
*GetImageList(const wxString
& param
= wxT("imagelist"));
591 #if wxUSE_ANIMATIONCTRL
592 // Gets an animation.
593 wxAnimation
GetAnimation(const wxString
& param
= wxT("animation"));
597 wxFont
GetFont(const wxString
& param
= wxT("font"), wxWindow
* parent
= NULL
);
599 // Gets the value of a boolean attribute (only "0" and "1" are valid values)
600 bool GetBoolAttr(const wxString
& attr
, bool defaultv
);
603 // Sets common window options.
604 void SetupWindow(wxWindow
*wnd
);
607 void CreateChildren(wxObject
*parent
, bool this_hnd_only
= false);
610 void CreateChildrenPrivately(wxObject
*parent
, wxXmlNode
*rootnode
= NULL
);
612 // Creates a resource from a node.
613 wxObject
*CreateResFromNode(wxXmlNode
*node
,
614 wxObject
*parent
, wxObject
*instance
= NULL
)
615 { return m_resource
->CreateResFromNode(node
, parent
, instance
); }
619 wxFileSystem
& GetCurFileSystem() { return m_resource
->GetCurFileSystem(); }
622 // reports input error at position 'context'
623 void ReportError(wxXmlNode
*context
, const wxString
& message
);
624 // reports input error at m_node
625 void ReportError(const wxString
& message
);
626 // reports input error when parsing parameter with given name
627 void ReportParamError(const wxString
& param
, const wxString
& message
);
631 // Programmer-friendly macros for writing XRC handlers:
633 #define XRC_ADD_STYLE(style) AddStyle(wxT(#style), style)
635 #define XRC_MAKE_INSTANCE(variable, classname) \
636 classname *variable = NULL; \
638 variable = wxStaticCast(m_instance, classname); \
640 variable = new classname;
643 // FIXME -- remove this $%^#$%#$@# as soon as Ron checks his changes in!!
644 WXDLLIMPEXP_XRC
void wxXmlInitResourceModule();
647 // This class is used to create instances of XRC "object" nodes with "subclass"
648 // property. It is _not_ supposed to be used by XRC users, you should instead
649 // register your subclasses via wxWidgets' RTTI mechanism. This class is useful
650 // only for language bindings developer who need a way to implement subclassing
651 // in wxWidgets ports that don't support wxRTTI (e.g. wxPython).
652 class WXDLLIMPEXP_XRC wxXmlSubclassFactory
655 // Try to create instance of given class and return it, return NULL on
657 virtual wxObject
*Create(const wxString
& className
) = 0;
658 virtual ~wxXmlSubclassFactory() {}
662 /* -------------------------------------------------------------------------
663 Backward compatibility macros. Do *NOT* use, they may disappear in future
664 versions of the XRC library!
665 ------------------------------------------------------------------------- */
669 #endif // _WX_XMLRES_H_