wxXmlResource

This is the main class for interacting with the XML-based resource system.

The class holds XML resources from one or more .xml files, binary files or zip archive files.

See XML-based resource system overview for details.

Derived from

wxObject

Include files

<wx/xrc/xmlres.h>

Data structures

enum wxXmlResourceFlags
{
    wxXRC_USE_LOCALE     = 1,
    wxXRC_NO_SUBCLASSING = 2
};



wxXmlResource::wxXmlResource



wxXmlResource(const wxString& filemask, int flags = wxXRC_USE_LOCALE)

Constructor.

filemask
The XRC file, archive file, or wildcard specification that will be used to load all resource files inside a zip archive.

flags
wxXRC_USE_LOCALE: translatable strings will be translated via _(). wxXRC_NO_SUBCLASSING: subclass property of object nodes will be ignored (useful for previews in XRC editors).



wxXmlResource(int flags = wxXRC_USE_LOCALE)

Constructor.

flags
wxXRC_USE_LOCALE: translatable strings will be translated via _(). wxXRC_NO_SUBCLASSING: subclass property of object nodes will be ignored (useful for previews in XRC editors).



wxXmlResource::~wxXmlResource



~wxXmlResource(void)

Destructor.



wxXmlResource::AddHandler



void AddHandler(wxXmlResourceHandler* handler)

Initializes only a specific handler (or custom handler). Convention says that the handler name is equal to the control's name plus 'XmlHandler', for example wxTextCtrlXmlHandler, wxHtmlWindowXmlHandler. The XML resource compiler (wxxrc) can create include file that contains initialization code for all controls used within the resource.



wxXmlResource::AttachUnknownControl



bool AttachUnknownControl(const wxString& name, wxWindow* control, wxWindow* parent = NULL)

Attaches an unknown control to the given panel/window/dialog. Unknown controls are used in conjunction with <object class="unknown">.



wxXmlResource::ClearHandlers



void ClearHandlers(void)

Removes all handlers.



wxXmlResource::CompareVersion

int CompareVersion(int major, int minor, int release, int revision) const

Compares the XRC version to the argument. Returns -1 if the XRC version is less than the argument, +1 if greater, and 0 if they equal.



wxXmlResource::Get



wxXmlResource* Get(void)

Gets the global resources object or creates one if none exists.



wxXmlResource::GetFlags



int GetFlags(void)

Returns flags, which may be a bitlist of wxXRC_USE_LOCALE and wxXRC_NO_SUBCLASSING.



wxXmlResource::GetVersion

long GetVersion(void) const

Returns version information (a.b.c.d = d+ 256*c + 256^2*b + 256~3*a).



wxXmlResource::GetXRCID



int GetXRCID(const wxChar* str_id)

Returns a numeric ID that is equivalent to the string ID used in an XML resource. To be used in event tables. The macro XRCID(name) is provided for convenience.



wxXmlResource::InitAllHandlers



void InitAllHandlers(void)

Initializes handlers for all supported controls/windows. This will make the executable quite big because it forces linking against most of the wxWidgets library.



wxXmlResource::Load



bool Load(const wxString& filemask)

Loads resources from XML files that match given filemask. This method understands VFS (see filesys.h).



wxXmlResource::LoadBitmap



wxBitmap LoadBitmap(const wxString& name)

Loads a bitmap resource from a file.



wxXmlResource::LoadDialog



wxDialog* LoadDialog(wxWindow* parent, const wxString& name)

Loads a dialog. dlg points to a parent window (if any).



bool LoadDialog(wxDialog* dlg, wxWindow* parent, const wxString& name)

Loads a dialog. dlg points to parent window (if any).

This form is used to finish creation of an already existing instance (the main reason for this is that you may want to use derived class with a new event table).

Example:

  MyDialog dlg;
  wxTheXmlResource->LoadDialog(&dlg, mainFrame, "my_dialog");
  dlg->ShowModal();



wxXmlResource::LoadFrame



bool LoadFrame(wxFrame* frame, wxWindow* parent, const wxString& name)

Loads a frame.



wxXmlResource::LoadIcon



wxIcon LoadIcon(const wxString& name)

Loads an icon resource from a file.



wxXmlResource::LoadMenu



wxMenu* LoadMenu(const wxString& name)

Loads menu from resource. Returns NULL on failure.



wxXmlResource::LoadMenuBar



wxMenuBar* LoadMenuBar(wxWindow* parent, const wxString& name)

Loads a menubar from resource. Returns NULL on failure.



wxMenuBar* LoadMenuBar(const wxString& name)

Loads a menubar from resource. Returns NULL on failure.



wxXmlResource::LoadPanel



wxPanel* LoadPanel(wxWindow* parent, const wxString& name)

Loads a panel. panel points to parent window (if any).



bool LoadPanel(wxPanel* panel, wxWindow* parent, const wxString& name)

Loads a panel. panel points to parent window (if any). This form is used to finish creation of an already existing instance.



wxXmlResource::LoadToolBar



wxToolBar* LoadToolBar(wxWindow* parent, const wxString& name)

Loads a toolbar.



wxXmlResource::Set



wxXmlResource* Set(wxXmlResource* res)

Sets the global resources object and returns a pointer to the previous one (may be NULL).



wxXmlResource::SetFlags



void SetFlags(int flags)

Sets flags (bitlist of wxXRC_USE_LOCALE and wxXRC_NO_SUBCLASSING).

ymasuda 平成17年11月19日